Szukam czegoś co finalnie wyprodukuje PDFa z hyperlinkami do nawigacji w ramach dokumentu. Póki co skłaniam się do markdowna, który ma pewne zalety, ale jest dość toporny w konwersji do pojedynczego pliku PDF (trzeba trochę gimnastyki/preprocessingu przed konwersją via pandoc
).
Ogólnie, zamiast jednego dużego pliku chciałbym mieć taką organizację dokumentacji:
docs
+-overview
+-part1
+-chapter1
+-chatper2
...
+-part2
...
Jakich narzędzi używacie do tworzenia dokumentacji i jak się Wam to sprawdza? Co teraz jest "main streamowe"?