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 ).

In the above code:


 * replace <> with your Wiki user name
 * replace cp437 with your console_encoding. To find out what is your console encoding, for Windows and Linux, launch the Python interpreter, enter followed by . Python will write your  on the screen.

Then you must save the following Python code as a file with the name under the sub-directory  (together with the other  files).

Usage
You are now all set to launch the Pywikibot scripts. The scripts themselves are contained in the subdirectory, from which you can know the names.

To launch the scripts, open a shell and move to the base directory (the installation one, NOT the subdirectory), and write

where of course you replace < > with the name of the script you are interested in, and < > with the parameter(s) required for the given script.

To have a description of the usage and parameters of any script, simply use the -help parameter. For instance, to have a description of the script (one of the most useful), type

There is another very useful parameter, valid for all the scripts, called -simulate, that allows you to test commands without harming the Wiki. Use it, before going 'live'.

Examples
This command will log into the wiki

This command will print a list of all the pages containing a link to SourceForge

This command will replace all the links to the old SourceForge Forum with a link to the new freecadweb.org-hosted Forum

This command will print a list of all the pages containing the word 'PartDesign', starting with the page titled "2d Drafting Module" and going on alphabetically

This command will replace all the secure links to the old SourceForge Forum with a link to the new freecadweb.org-hosted Forum in the translated pages

FreeCAD Wiki Related Commands
Count all pages that a specific wiki templates is used in

List all pages that a specific wiki templates is used in

Replace a string in all the pages listed in the Arch category (a/k/a )