Encyklopedia_import/README

Copyright © 2017 Paulina Laura Emilia <vilene@posteo.net>

You can redistribute this file and/or modify it under the terms of the Do What
The Fuck You Want To Public License, Version 2, as published by Sam Hocevar.
See the COPYING file for more details.

* Skrypty importu Encyklopedii Wandejskiej

Znajdujące się tutaj skrypty ułatwiają import artykułów z Micropedii oraz
SclaviniaWiki do Encyklopedii Wandejskiej. Wymagają one do swojego działania
systemu operacyjnego zgodnego ze standardem POSIX, takiego jak GNU/Linux lub
systemy z rodziny BSD, oraz narzędzia konwertującego Pandoc: http://pandoc.org/

Aby pobrać skrypty na swój komputer, najlepiej jest zainstalować system kontroli
wersji git (https://git-scm.com/) i wykonać następującą komendę:

	git clone https://repo2.mydevil.net/git/pub/wandystan/ency/

** mediawiki2ency.sh

Konwertuje pliki tekstowe sformatowane za pomocą znaczników MediaWiki na używany
w Systemie Stron Wandejskich dialekt Markdowna i dodaje informację o źródle
artykułu oraz jego licencji. Zalecane użycie:

	./mediawiki2ency.sh [--nosrc|--sclavinia] plik_źródłowy
		"Tytuł strony" > plik_docelowy

Przełącznik `--nosrc' powoduje niedołączanie do strony informacji o jej źródle
i nie jest konieczne w tym przypadku podawanie jej tytułu.

** encyimport.sh

Pobiera artykuły z Micropedii i SclaviniaWiki według listy podanej na
standardowym wejściu, konwertuje je na Markdown i zapisuje w katalogu bieżącym
pod nazwą `Tytuł_strony.markdown'. Do swojego działania wymaga skryptu
mediawiki2ency.sh w jednym z katalogów ścieżki wyszukiwania ($PATH) lub
w katalogu bieżącym. Zalecane użycie:

	./encyimport.sh [--sclavinia] < plik_z_listą_stron

Aby pobrać pojedynczą stronę, można użyć następującego polecenia:

	echo 'Tytuł strony' | ./encyimport.sh [--sclavinia]

** Contributing

Jeżeli posiadasz propozycję poprawki, gotowego patcha, nowy skrypt lub po prostu
chcesz zgłosić błąd, skontaktuj się z tow. Polyną wysyłając wiadomość e-mail
na adres <polyna@posteo.net>.