search

soulcharmer / pc_for_beginners_cheatsheet

AsciiDoc templates for beginner user stories to use personal computers
GNU General Public License v3.0
1 stars 0 forks source link

[0] AsciiDoc installation user story #2

Open soulcharmer opened 7 years ago

soulcharmer commented 7 years ago

Please investigate this user story for existing material and then prepare a cheatsheet draft for it.

Check and update this file as necessary:

https://github.com/soulcharmer/pc_for_beginners_cheatsheet/blob/master/resources

User story specs:

how to set up my AsciiDoc tool chain - 3 main sub-tasks

install and setup AsciiDoc-friendly text editor
install and setup an AsciiDoc processor, such as AsciiDoctor
compose and build a sample file
yzimmerm commented 7 years ago

I would suggest using https://asciidoclive.com/ instead of installing an AsciiDoctor-friendly editor. This requires NO installation and provides immediate preview of the text.

yzimmerm commented 7 years ago

Depending on output format they may need to install AsciiDoctor which also provides processing functionality: http://asciidoctor.org/. For HTML output, asciidoclive will be enough. To install asciidoctor:

  1. Install gem
  2. Install asciidoctor with the following command: gem install asciidoctor Very simple.