Nice work Laurent! I threw the instructions together rather quickly, so that's definitely something to improve upon. No doubt, this backend is just emerging from the proof of concept stage :)
I realized that I forgot to upload the zip file to GitHub, which I've now done. The trickiest part about AsciiDoc is managing the assets. The simplest approach is to embed the assets in the document. If you link the assets, then they have to be in the same directory as the final presentation, which is what you had to do to get it working. I'll update the instructions to be clearer. -Dan On Wed, Dec 5, 2012 at 10:35 AM, Laurent Laville <[email protected]>wrote: > The result is available at > http://laurent-laville.org/asciidoc/base-css-book/base-css-book.html > > Le mercredi 5 décembre 2012 18:25:06 UTC+1, Laurent Laville a écrit : > >> Hello >> >> I've investigate, because i think asciidoc-bootstrap backend is one of >> the fabulous gift of the end of this year : Thanks Dan ! >> >> So I've : >> >> - repackage the contents of source code like that in a archive [1] >> - install the new backend using command asciidoc --backend install >> bootstrap-docs-v1.0.0.zip >> - I've been force to rename the directory created >> $HOME/.asciidoc/backends/**boostrap to this one $HOME/.asciidoc/backends/ >> **boostrap-docs >> >> In the target directory (/tmp) where I put the example source file >> base-css-book.asciidoc >> >> I run this command : >> asciidoc --backend bootstrap-doc -a toc /tmp/base-css-book.asciidoc >> >> And the result was not expected [2] until I copied from the backend all >> the content of $HOME/.asciidoc/backends/**boostrap-docs/boostrap >> to my target dir /tmp >> And also the asciidoc.js to have the dynamic table of contents. >> >> Well there are some thing to fix for the next version Dan, or did I >> missed something ? >> Asset copy from backend to target dir is not done >> >> - Laurent >> >> [1] >> http://laurent-laville.org/**asciidoc/bootstrap-docs-v1.0.**0.zip<http://laurent-laville.org/asciidoc/bootstrap-docs-v1.0.0.zip> >> [2] http://cloud.github.com/**downloads/mojavelinux/** >> asciidoc-bootstrap-docs-**backend/example.html<http://cloud.github.com/downloads/mojavelinux/asciidoc-bootstrap-docs-backend/example.html> >> >> >> >> >> Le mercredi 5 décembre 2012 07:30:03 UTC+1, ping a écrit : >>> >>> On 12/3/2012 5:33 PM, Dan Allen wrote: >>> > For those who like style... >>> > >>> > I've been getting a little crazy exploring how varied and presentable >>> I >>> > can make the AsciiDoc output. In my previous message, I shared my >>> > dzslides backend [1] which produced these HTML5-based presentations >>> [2]. >>> > >>> > We all love Twitter Bootstrap and there's no question their >>> > documentation, which is based on Bootstrap, is pretty slick looking >>> [3]. >>> > I wanted to see if I could reproduce that page using AsciiDoc and a >>> > custom backend [4] (employing as few tricks as possible). I'm happy to >>> > report that I could match it almost 1-to-1 [5] (with the exception of >>> > non-documentation elements such as forms and buttons, and a few >>> > limitations on styling tables). I'm going to keep working to simplify >>> > the AsciiDoc source document and backend, perhaps even enough to >>> compel >>> > Twitter to adopt it :) You are welcome to join the effort! >>> > >>> > Cheers, >>> > >>> > -Dan >>> > >>> > p.s. In the process of developing the bootstrap-docs backend, I >>> realized >>> > that AsciiDoc could really use a base HTML5 backend that is much more >>> > minimal and makes maximum use of HTML5 tags (section, article, aside, >>> > etc). I'll likely refactor that out of the bootstrap-docs backend so >>> > that I have less to override. I also plan to create a vanilla >>> bootstrap >>> > backend that doesn't use the extra assets used in the documentation. >>> > >>> > [1] >>> > https://github.com/**mojavelinux/asciidoc-dzslides-**backend<https://github.com/mojavelinux/asciidoc-dzslides-backend> >>> > [2] >>> > http://mojavelinux.github.com/**decks/<http://mojavelinux.github.com/decks/> >>> > [3] >>> > http://twitter.github.com/**bootstrap/base-css.html<http://twitter.github.com/bootstrap/base-css.html> >>> > [4] >>> > https://github.com/**mojavelinux/asciidoc-**bootstrap-docs-backend<https://github.com/mojavelinux/asciidoc-bootstrap-docs-backend> >>> > [5] http://cloud.github.com/**downloads/mojavelinux/** >>> asciidoc-bootstrap-docs-**backend/example.html<http://cloud.github.com/downloads/mojavelinux/asciidoc-bootstrap-docs-backend/example.html> >>> > >>> > -- >>> > You received this message because you are subscribed to the Google >>> > Groups "asciidoc" group. >>> > To view this discussion on the web visit >>> > https://groups.google.com/d/**msg/asciidoc/-/jtkLIOGo2EMJ<https://groups.google.com/d/msg/asciidoc/-/jtkLIOGo2EMJ>. >>> >>> > To post to this group, send email to [email protected]. >>> > To unsubscribe from this group, send email to >>> > [email protected]**. >>> > For more options, visit this group at >>> > http://groups.google.com/**group/asciidoc?hl=en<http://groups.google.com/group/asciidoc?hl=en>. >>> >>> >>> Just a test drive to the new backend: >>> https://github.com/**mojavelinux/asciidoc-**bootstrap-docs-backend<https://github.com/mojavelinux/asciidoc-bootstrap-docs-backend> >>> >>> 1) this link in that page is dead. >>> https://github.com/downloads/**mojavelinux/asciidoc-** >>> bootstrap-docs-backend/**bootstrap-docs.zip<https://github.com/downloads/mojavelinux/asciidoc-bootstrap-docs-backend/bootstrap-docs.zip> >>> >>> so I can only use this to install: >>> https://github.com/**mojavelinux/asciidoc-**bootstrap-docs-backend/** >>> archive/master.zip<https://github.com/mojavelinux/asciidoc-bootstrap-docs-backend/archive/master.zip> >>> >>> 2) I tried to generate the html with the new backend, >>> using this as source: >>> https://raw.github.com/**mojavelinux/asciidoc-** >>> bootstrap-docs-backend/master/**examples/base-css-book.**asciidoc<https://raw.github.com/mojavelinux/asciidoc-bootstrap-docs-backend/master/examples/base-css-book.asciidoc> >>> >>> but what I got is no way like this: >>> http://cloud.github.com/**downloads/mojavelinux/** >>> asciidoc-bootstrap-docs-**backend/example.html<http://cloud.github.com/downloads/mojavelinux/asciidoc-bootstrap-docs-backend/example.html> >>> >>> attached is what I got. >>> >>> the command I use to generate the page is : >>> asciidoc -b bootstrap-docs -a toc base-css-book.asciidoc >>> >>> please advise if possible. >>> >> -- Dan Allen Principal Software Engineer, Red Hat | Author of Seam in Action Registered Linux User #231597 http://google.com/profiles/dan.j.allen http://mojavelinux.com http://mojavelinux.com/seaminaction -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.
