WikiRobots/pl

Informacje ogólne
Powtarzalne zadania mogą być zautomatyzowane za pomocą robotów lub botów, czyli programów komputerowych działających samodzielnie na wiki.

Naturalne i najczęściej używane roboty dla stron wiki są dostarczane przez MediaWiki, pod nazwą pakietu Pywikibot. Zobacz Manual:Pywikibot, aby uzyskać pełne informacje.

W skrócie, Pywikibot jest zbiorem skryptów Pythona zdolnych do używania natywnego API wiki do działania na stronach wiki. Aby zobaczyć listę API dla FreeCAD wiki, odwiedź http://www.freecadweb.org/wiki/api.php.

Aby korzystać z Pywikibota, należy:


 * 1) zainstaluj pakiet Pywikibot
 * 2) skonfiguruj Pywikibota do pracy na FreeCAD Wiki
 * 3) uruchom skrypty potrzebne do wykonania danego zadania

Istnieje wiele informacji o tym jak zainstalować, skonfigurować i używać Pywikibota. Należy jednak pamiętać, że informacje te, choć przydatne, mogą być mylące, ponieważ mieszają instrukcje dotyczące dwóch różnych baz kodu Pywikibota i różnych wersji kolekcji skryptów Pywikibota.

Poniżej znajdziesz podstawowe instrukcje, jak skonfigurować i używać Pywikibota na wiki FreeCAD. Pozwoli Ci to na wykonywanie najczęstszych zadań. W celu uzyskania bardziej zaawansowanych informacji należy zapoznać się z Manual:Pywikibot oraz z kodem źródłowym w środowisku Python.

Instalacja
Wejdź na stronę http://tools.wmflabs.org/pywikibot/ i pobierz (projekt jest również na githubie, gerrit, itp., ale jest to prosty sposób, aby uzyskać pełny, samodzielny pakiet).

Rozpakuj zawartość w wybranym przez siebie katalogu.

Jeśli nie chcesz zainstalować bibliotek w lokalizacji swoich bibliotek Python, to już po wszystkim (jeśli nadal chcesz je zainstalować, sprawdź plik w katalogu bazowym).

Pywikibot działa ze środowiskiem Python v2.6 i v2.7 bez żadnych problemów. Python 3 nie był testowany do tej pory z FreeCAD wiki działa równie dobrze.

Konfiguracja
Musisz zapisać poniższy kod Pythona jako plik o nazwie w katalogu bazowym, w którym rozpakowałeś  (dla jasności, w tym samym katalogu, w którym znajdziesz już plik o nazwie ).

W powyższym kodzie:


 * zamień <> na nazwę użytkownika Wiki
 * zastąp cp437 swoim console_encoding. Aby dowiedzieć się, jakie jest kodowanie twojej konsoli, w systemach Windows i Linux uruchom interpreter Pythona, wpisz, a następnie . Python wyświetli twoje na ekranie.

Następnie musisz zapisać poniższy kod Pythona jako plik o nazwie w podkatalogu  (razem z innymi plikami ).

Użycie
Teraz możesz już uruchamiać skrypty Pywikibota. Same skrypty znajdują się w podkatalogu, z którego możesz poznać ich nazwy.

Aby uruchomić skrypty, należy otworzyć konsolę i przejść do katalogu bazowego (instalacyjnego, NIE podkatalogu ), a następnie napisać

gdzie oczywiście zastępujemy < > nazwą interesującego nas skryptu, a < > parametrem(ami) wymaganym(i) dla danego skryptu.

Aby mieć opis użycia i parametrów dowolnego skryptu, po prostu użyj parametru -help. Na przykład, aby uzyskać opis skryptu (jeden z najbardziej użytecznych), wpisz

Istnieje jeszcze jeden bardzo użyteczny parametr, ważny dla wszystkich skryptów, o nazwie -simulate, który pozwala na testowanie poleceń bez szkody dla Wiki. Warto go użyć przed rozpoczęciem pracy na żywo.

Przykłady
Ta komenda zaloguje do wiki

To polecenie wydrukuje listę wszystkich stron zawierających link do SourceForge

To polecenie zastąpi wszystkie linki do starego forum SourceForge linkiem do nowego forum hostowanego przez freecadweb.org

To polecenie wydrukuje listę wszystkich stron zawierających słowo PartDesign, zaczynając od strony zatytułowanej "2d Drafting Module" i idąc dalej alfabetycznie

Ta komenda zastąpi wszystkie bezpieczne linki do starego forum SourceForge linkiem do nowego forum hostowanego przez freecadweb.org na przetłumaczonych stronach

FreeCAD Wiki Powiązane komendy
Policz wszystkie strony, na których użyto określonego szablonu wiki

Lista wszystkich stron, na których użyty jest określony szablon Wiki

Zamień ciąg we wszystkich stronach wymienionych w kategorii Arch (a/k/a )