Baseline style and content

[johncarl81]

I'd like to include a set of basic styles and content for user's to have as an example. The benefits of this is highlighting the features of jekyll-asciidoc and getting the user up and going with a good looking site with little or no effort. The drawback is that this content and style will probably be applied to a high percentage of the user's sites. Therefore we need to strike a balance between what to include and what to not include. Im thinking we should include the following:

• Base css and layout - Bootstrap or another css framework along with the basic Asciidoctor css
• Home page - Includes the steps to get up and running, much like the README should
• Initial blog post - Maybe a bit less necessary, but this is a really neat feature of jekyll

Thoughts?

[paulrayner]

I really like this idea! 👍 Please feel free to use anything from https://github.com/paulrayner/paulrayner.github.com for this quickstart, and I'll help wherever I can.

[jaredmorgs]

That initial blog post you see when you stand-up the jekyll-now repo gives you the answer to the "what now" question you might have. It's a nice little "call to action" for new users. Barry's done a great job laying out that repo.

[mojavelinux]

Base css and layout

This is going to be solved by asciidoctor/asciidoctor-stylesheet-factory#18. It's high on my list because it is needed in so many places.

It's possible to use the existing default stylesheet, as @paulrayner has done, but we could make it a lot nicer by stripping away the bits that aren't needed for styling embeddable HTML. This is something I got wrong when I first created the default stylesheet and I really want to correct it make it easier on everyone.

[mojavelinux]

General feedback, huge 👍

[johncarl81]

Cool. I guess for the time being I can integrate the default stylesheet... no biggy.

I was also thinking about the starting look and feel. Here's some preliminary styling I came up with based on twitter bootstrap:
https://github.com/johncarl81/jekyll-asciidoc-quickstart
and a working version:
http://johncarl81.github.io/jekyll-asciidoc-quickstart/

I have to say, with @jirutka's rake-jekyll gem, this project makes setting up a new site a breeze! ⛵

[mojavelinux]

That's awesome. However, I would much prefer if the styling was based on Foundation 5.5. for Site instead of Bootstrap. I strongly believe Foundation is a better starting point for a few reasons:

1. It will integrate well with the default Asciidoctor stylesheet
2. It has much better typography practices
3. It provides all the things that bootstrap provides

See http://foundation.zurb.com/docs/

[johncarl81]

I noticed asciidoctor.org used Foundation and I was going to ask if that was your preference... I'll rely on your conviction here and set up something based on it. Thanks @mojavelinux.

[mojavelinux]

👍

Foundation has never let me down, and the ZURB team knows what the hell they are doing when it comes to responsive web design.