Socrates

Sokrates jest prosty generator strona statyczna nastawione na blogach. Możesz napisać swoje posty w ulubionym zwykły tekst do języka HTML (np Markdown, tekstylia) i zapisać je w postaci plików tekstowych na dysku twardym. Sokrates to bierze je i tworzy pełną stronę HTML dla Ciebie. Za darmo, otrzymasz stronę główną, która zawiera listę ostatnich postów, pojedyncze strony pocztowe, strony kategorii, stron archiwalnych, to temat strony i kanału Atom.
Zastosowanie
Po pierwsze, trzeba utworzyć nowy blog:
blog Sokratesa -i
Spowoduje to utworzenie katalogu blogu o prostej strukturze blogu:
blog
& nbsp; postów
& Nbsp; 2010-your-post.md
& Nbsp; układ
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
Media & nbsp;
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Katalog postów jest, gdzie można umieścić swoje pliki postów. Wszystko prefiksem _ lub. będą ignorowane. Układ jest podstawowy motyw lub szablonu. config.yaml plik konfiguracyjny jest w całej witrynie. Nie zapomnij, aby zaktualizować plik o odpowiednich informacji.
Można również utworzyć nowy blog w bieżącym katalogu roboczym:
Sokrates -i
Gdy jesteś gotowy do generowania witryny, można uruchomić:
blog Sokratesa -g
Albo,
Sokrates -g
w bieżącym katalogu.
Spowoduje to wszystkie wygenerowane pliki w blogu / wdrożyć. Następnie można podjąć ten katalog i przesłać go na serwer.
instalacji
Po pierwsze, utworzenie wirtualnego środowiska i pip install Sokratesa.
virtualenv env --no-site-pakiety
źródło env / bin / włączyć
pip install Sokratesa
Lub, aby uzyskać najnowsze kodu, można zainstalować z Github.
pip install -e git: //github.com/honza/socrates.git#egg=socrates
Następnym krokiem jest instalacja szablonów. W tej chwili, można wybrać pomiędzy szablonów Django i szablonów Jinja2. Domyślny motyw wykorzystuje Django.
Tematy
Sokrates obsługuje szablonów Django i szablony Jinja2. Można określić, które silnika szablonów chcesz korzystać w pliku config.yaml. Istnieją dwa podstawowe tematy w katalogu themes, aby zacząć grę.
Tekst HTML
Sokrates będzie attemp do konwersji plików tekstowych na format HTML przy użyciu edytor tekstu. Należy podać nazwę procesora tekstu w config.yaml. Powinno być pisane małymi literami. Obecnie obsługiwane procesory:
- Markdown
- Tekstylia
- ReStructuredText
- HTML (tekst bez modyfikacji)
Domyślnie tylko Sokrates instaluje procesory tekstu Markdown. Można zainstalować innych z pip:
pip install tekstylne
pip install docutils
Rozwoju
Możesz zacząć prosty serwer deweloperski do pomocy Państwa w rozwoju .:
blog Sokratesa -r
Albo,
Sokrates -r
w bieżącym katalogu.
Dokumentacja
Dokumentacja jest zawarta w katalogu docs i jest napisane w reStructuredText użyciu Sphinx. Dokumentacja jest łatwo odczytać w standardowym edytorze tekstu. Jednakże, można zbudować wersję HTML jak w przykładzie:
pip install sfinks
cd / docs
dokonać html
otwarta _build / html / index.html
Albo można zobaczyć w wersji online najnowszej dokumentacji

Opis .

• Znajome Django i Jinja2 szablonów
• Prosta instalacja przez pip
• Markdown, reStructuredText wsparcie tekstylne
• Konfiguracja YAML
• Kanał Atom
• strony GitHub kompatybilny

Wymagania :

• Python