Wątek przeniesiony 2023-07-01 09:24 z Inżynieria oprogramowania przez Riddle.

Dokumentacja którą można wyeksportować do pojedynczego PDF

0

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"?

0

O co konkretnie pytasz?
W google docs albo wordzie jak użyjesz poprawnie nagłówków to potem możesz użyć Wstaw -> Spis treści / Table of contents i generuje spis treści taki jak pokazałeś z linkami które działają też po wyeksportowaniu do pdfa, o to chodzi?

// a ok sorry przeczytałem jeszcze raz i doczytałem że chodzi o dokumentację i podział na pliki
No to w takim razie używam markdowna ale nie miałem nigdy potrzeby eksportowania tego do jednego pdfa

1

Podejynczy plik pdf brzmi w cholerę niemainstreamowo. A narzędzia do tworzenia/utrzymania dokumentacji, to:

  • Confluence, da się posklejać różne dokumenty w jeden eksport do pdf
  • Git z MD (ale ta toporność czasami wkurza, jak np. chcesz wstawić dodatkową kolumnę do tabelki)
  • Structurizr, ale nawet nie wiem, jak to miałoby wyglądać w .pdf
2
yarel napisał(a):

Szukam czegoś co finalnie wyprodukuje PDFa z hyperlinkami do nawigacji w ramach dokumentu.

Jeśli to jedyne wymaganie, to MS Word.

1 użytkowników online, w tym zalogowanych: 0, gości: 1