Jak sprawić, aby emacs org docs były piękniejsze w repozytorium github?

Question

github obsługuje kilka języków znaczników, z których jeden to Emacs org mode.

1. Ale zawsze wyglądają brzydko z domyślnego pliku CSS (dużo lepsze niż domyślny we wbudowany tryb org, choć.
2. Ponadto wydaje się, że kod blok źródło nie ma podświetlanie składni albo.

Więc to jest możliwe, aby uczynić go bardziej piękne, z niewielkimi zmianami w plikach org? czy możesz dać mi jakieś rady lub dobrą praktyką?

Answer 1

Github używa org-ruby do konwersji trybu org na html. Wygląda na to, że ostatnie wersje org-ruby obsługują zarówno słowa kluczowe w trybie org, jak i podświetlanie składni w blokach kodu źródłowego (między innymi fajnymi rzeczami). Dopóki nie zostanie zaktualizowany w oficjalnym Githubie, wygląda na to, że jedynymi opcjami są albo użycie dużej litery BEGIN_SRC/END_SRC, albo eksportowanie plików org do html/md w emacs z dowolnymi opcjami/css/etc, które lubisz i publikowanie wynikowych plików Github.

Answer 2

Obsługa Githubs Org-Mode została zaktualizowana , ale # + TITLE: jest nieobsługiwana, podobnie jak linki, które w większości zawierają błędy. Więc działa głównie.