Cała kompilacja strony markdown/pandoc?

Question

Dzięki Sphinx-doc można utworzyć kilka plików ReStructureText z plikiem index.rst, który zawiera makro spisu treści, które automatycznie generuje spis treści z innych dołączonych plików, oraz conf.py, który działa jako konfiguracja kompilacji. Następnie możesz skompilować partię w jedną stronę w stylu Pythona, wraz z indeksem, narzędziami nawigacyjnymi i funkcją wyszukiwania.

Czy istnieje porównywalne narzędzie do przeceny (najlepiej obniżka w stylu pandoc)?

Answer 1

Niektóre generatory statyczne witryny, które współpracują z promocji cenowych:

• Jekyll jest bardzo popularny, a także motorem GitHub pages.
• Python warianty: Hyde lub Pelican
• nanoc (stosowane f.ex. w GitHub API documentation)
• Middlemanapp: Być może najlepszy?

myślę, żaden z nich korzystać pandoc (może dlatego, że jest napisane w Haskell), ale wszystkie one używać składni Markdown zwiększoną lub może być skonfigurowany do korzystania pandoc.

Inne interesujące sposoby generowania witrynę z obniżki:

• Markdown- Wiki które są oparte pliku: f.ex. Gollum, silnik Wiki, który jest również używany przez GitHub
• Telegram: komercyjny; napisany przez Davida Pollak, wynalazca Lift-Scala-ramowej

silników, które wykorzystują Pandoc:

• Gitit: Pandoc Wiki
• Pandoc-Plugin forIkiwiki
• Yst static site generator
• Gouda - generates a site from a directory of markdown files
• Rippledoc - generates a navigable site from nested directories of markdown files

Ostateczne zestawienie statycznej strony Generatory

Dobry przegląd statycznych generatorów strony: http://staticsitegenerators.net/

Answer 2

Pandoc, GNU make i sed polecenia, posypane jakimś CSS to wszystko czego potrzebujesz w pełni zautomatyzować tworzenie statycznej strony internetowej zaczynając od Markdown.

Pandoc oferuje trzy opcje wiersza poleceń, które umożliwiają nawigację między stronami, a także tworzenie spisu treści (TOC) na podstawie nagłówków na stronie. Dzięki CSS możesz sprawić, że nawigacja i spis treści wyglądają i zachowują się tak, jak chcesz.

-B FILE, --include-przed-body = PLIK

Dołącz zawartość pliku, dosłownie na początku treści dokumentu (np po tagu w HTML lub \ begin { document} w LaTeX). Można to wykorzystać do umieszczenia pasków nawigacyjnych lub banerów w dokumentach HTML. Ta opcja może być wielokrotnie używana w celu uwzględnienia wielu plików. Zostaną one uwzględnione w podanej kolejności. Implies --standalone.

--toc, --table-of-zawartość

Dołącz automatycznie wygenerowanego spisu treści.

--toc głębokości = liczba

Określanie liczby poziomów umieścić w spisie treści. Wartość domyślna to 3 (co oznacza, że ​​nagłówki poziomu 1, 2 i 3 zostaną wyświetlone w treści).

W rzeczywistości my personal website is built this way. Sprawdź jego numer makefile, aby uzyskać więcej informacji. To licencja open-source na licencji open-source pod numerem GNU GPL version 3.

Answer 3

Jeśli nie używasz Pandoc, mkdocs wydaje się pasować do twoich potrzeb.

Jeśli na pewno chcesz użyć Markdown o smaku pandoc, możesz wypróbować pdsite. Napisałem to jako sposób na wygenerowanie strony w stylu mkdocs z większą ilością formatów wejściowych (jak tryb emacs org) i bez zależności Pythona - przekazujesz folder plików Markdown i wyciągasz stronę HTML (w tym automatycznie generowaną wiele poziomy nawigacji nawigacyjnej). Jest podobny do podejścia Serge'a Stroobandta, ponieważ jest to po prostu skrypt powłoki (wymaga on jednak zainstalowania tree). Niestety nie ma jeszcze funkcji wyszukiwania, chociaż nie byłoby to zbyt trudne do dodania ...