Hello All, I forgot to mention one other Asciidoctor benefit, which is significant, "Speed".
* WSJT-X v1.6.1 User_Guide * Single core 2.5Ghz, i5, non-parllel * No modifications to the *.adoc files * cd ^/src/wsjtx_exp/doc/user_guide/ time asciidoc -a toc2 -a data-uri wsjtx-main.adoc real...: 0m4.208s user...: 0m3.696s sys....: 0m0.332s time asciidoctor -a toc=left -a data-uri wsjtx-main.adoc real...: 0m0.303s user...: 0m0.264s sys....: 0m0.040s Speed Up Real...: 13.887 User...: 14.0 Sys....: 8.3 You be the judge :-) In order to render the tests above, Asciidoctor will look for the icons folder under ^/src/wsjtx_exp/doc/user_guide/images/icons, so you'll need to copy those from your AsciiDoc installation folder first. If the Admonitions were updated to use the Asciidoctor defaults, no icons would be needed at all under the ^/image folder 73's Greg, KI7MT On 11/09/2015 04:15 AM, KI7MT wrote: > Hello All, > > I put together a few small examples for various items in WSJT-X manual > using Asciidoctor. There are many more than what is provided here, > including a Math module for displaying LaTex type mathematical > expressions. The CSS colouring can be adjusted as desired with a custom > stylesheet. > > I've also provided ( in the examples ) links to their user guide and the > Quick Reference material. The Quick reference has both the sample code > and rendered html. > > There are 4 files in the 7z archive: > * wsjt-examples.adoc > * wsjt-examples-no-toc.html5 > * wsjt-examples-left-toc.html5 > * wsjt-examples-right-toc.html5 > > The default backend is html5; you do not need to specify the backend nor > the output file name, but I did for example clarity. > > > *TO COMPILE* > > asciidoctor <source-file> > > Left TOC Example: > asciidoctor -a toc=left wsjt-examples.adoc > > Which renders (in html5): wsjt-examples.html > > Personally, I like the right toc version as it seems to have the best > view for the main content. Another nice addition is the ability to add > Keyboard Button Indicators (F1, F2, ALT+F4, etc) rather than writing out > the text. > > There are many new features in Asccidoctor, most all of the original > AsciiDoc syntax is still valid. > > In their user guide / quick ref guides, they highlight which features > are only Ascidoctor and provide html rendering, for example, see their > quick reference guide text formatting section, then click on the "view > results": > > http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#formatted-text > > > 73's > Greg, KI7MT > > > > > > > > > > > > > > ------------------------------------------------------------------------------ > Presto, an open source distributed SQL query engine for big data, initially > developed by Facebook, enables you to easily query your data on Hadoop in a > more interactive manner. Teradata is also now providing full enterprise > support for Presto. Download a free open source copy now. > http://pubads.g.doubleclick.net/gampad/clk?id=250295911&iu=/4140 > > > > _______________________________________________ > wsjt-devel mailing list > wsjt-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/wsjt-devel > -- ---------------------------------------------------------------- Launchpad....: https://launchpad.net/~ki7mt Ubuntu Hams..: https://launchpad.net/~ubuntu-hams-devel Debian Hams..: https://alioth.debian.org/projects/pkg-hamradio/ JTSDK........: https://sourceforge.net/projects/jtsdk/ OpenPGP......: C177 6630 7115 78FE 9A2B 9F7F 18C0 F6B7 0DA2 F991 ------------------------------------------------------------------------------ Presto, an open source distributed SQL query engine for big data, initially developed by Facebook, enables you to easily query your data on Hadoop in a more interactive manner. Teradata is also now providing full enterprise support for Presto. Download a free open source copy now. http://pubads.g.doubleclick.net/gampad/clk?id=250295911&iu=/4140 _______________________________________________ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
