AsciiDoc: plain text for fancy output
AsciiDoc is a great text tool for documentation from simple notes to books. AsciiDoc is human readable plain text markup.
Since it’s plain text, AsciiDoc lends itself to revision control systems. Even WebUI systems like GitHub wiki can support it.
AsciiDoc was created in 2002 as a human readable format for publishing DocBook XML. Via different backend processors, it can be converted to many other formats as well. Plain text, revision control and wikifiable is a trifecta of sysadmin documentation awesomeness.
Important AsciiDoc features:
- human readable plain text markup
- easy learning curve
- many output formats ( HTML, DocBook, man pages, ODF, ePub, PDF, and more )
- widely supported
- ease of revision control
- detailed, complex formatting available when needed
- GPLv2
After attending this session, audience members will be familiar with basic AsciiDoc syntax and exporting to different backend formats. They will also learn advantages and disadvantages of AsciiDoc and Markdown.
Presenters
lufthans
As a volunteer der.hans endeavors to help build community through FLOSS conference and user group leadership.
Hans has co-chaired Open Source Career Day (OSCD) at Southern California Linux Expo (SCaLE) and the Finance and Partnership committees for SeaGL.
Hans presents and gives career counseling sessions at community-led conferences (SCaLE, SeaGL, Tux-Tage, Kielux, GeekBeacon Fest, FOSSASIA, LCA, LFNW, Tübix, OLF ) and many local groups. Hans is chairperson of the Phoenix Linux User Group (PLUG) and founder of the Free Software Stammtisch.
To stave off insolvency Hans manages a team of 24/7 database support engineers.
Fediverse/Mastodon - https://floss.social/@FLOX_advocate