Εγχειρίδιο:Pywikibot/Εγκατάσταση
Αυτή η σελίδα θα σας βοηθήσει να ξεκινήσετε με την εγκατάσταση και την εκτέλεση του Pywikibot στους δικούς σας υπολογιστές. Υπάρχουν τέσσερα κύρια βήματα σε αυτή τη διαδικασία:
Εγκατάσταση Python
Κατεβάστε και εγκαταστήστε την Python από το https://www.python.org/downloads/.
Αν έχετε ήδη εγκατεστημένη την Python, ελέγξτε αν η έκδοσή σας είναι αρκετά πρόσφατη εκτελώντας python --version σε μια κονσόλα.
To discover if Python version 3 or above is installed, run python3 --version in a console.
Ubuntu 19.04 and up comes with versions 2 & 3 installed.
Python v2 runs by default using terminal command python; to use v3, use terminal command python3.
Python 3.7 or higher is currently required to run the bot.
On Windows please do not forget to modify PATH environment variable to make Python and pip work properly.
Install dependencies
Additional packages are required to run Pywikibot. Run the following command to install these packages:
$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging
For Python 3.7 an additional package is required. Install it with:
$ python -m pip install importlib_metadata
An alternate MediaWiki markup parser may be installed with:
$ python -m pip install "wikitextparser>=0.47.5"
See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start
Κατέβασμα του Pywikibot
$ python -m pip install pywikibot
If using pip, use pwb instead of python pwb.py in examples below.
Αποσυμπιέστε αυτό το αρχείο, για παράδειγμα στο ~/pywikibot ή στο %USERPROFILE%\pywikibot.
Εναλλακτικά, αν θέλετε να ανακτήσετε την τελευταία έκδοση από το gerrit με τη χρήση git ή svn, δείτε το $1.
Εναλλακτικά, οι τελευταίες ενημερώσεις στο τέλος κάθε ημέρας είναι διαθέσιμες για κατέβασμα στο https://tools.wmflabs.org/pywikibot/.
Ενημέρωση
Σταθερές εκδόσεις κυκλοφορούν κάθε τρεις μήνες ή κάπου τόσο, και είναι διαθέσιμες στην ίδια τοποθεσία.
Εάν χρησιμοποιείτε έκδοση που κυκλοφόρησε μέσω git ή svn, μπορείτε να παραλείψετε αυτήν τη σημείωση. Διαφορετικά, λάβετε υπόψη σας την ανάγκη να πάρετε αντίγραφα ασφαλείας των αρχείων διαμόρφωσης και των δεσμών ενεργειών σας (το user-config.py, οποιοδήποτε αρχείο οικογένειας wiki ή προσαρμοσμένη δέσμη ενεργειών που ενδέχεται να έχετε δημιουργήσει ή τροποποιήσει και οποιοδήποτε τρέχον αρχείο εξαγωγής σε XML που χρησιμοποιείτε για κάποιο wiki) πριν από την εγκατάσταση νέας κυκλοφορίας.
Αποσυμπιέστε τη νέα έκδοση πάνω από την παλιά έκδοση, αντικαθιστώντας όλα τα αρχεία.
Παραμετροποίηση του Pywikibot
Ανοίξτε ένα τερματικό και αλλάξτε κατάλογο (cd) πηγαίνοντας εκεί που έχετε αποσυμπιέσει το pywikibot.
- Συστήματα τύπου Unix (Linux/BSD/Solaris):
$ cd ~/core
- Windows:
$ c: $ cd "%USERPROFILE%\pywikibot"
Φυσικά αντικαθιστώντας την τοποθεσία όπου έχετε αποσυμπιέσει το pywikibot.
Continue with the following command to generate user configuration file:
$ python pwb.py generate_user_files
Ακολουθήστε τις οδηγίες για να ρυθμίσετε το pywikibot.
Finally run the following command to log in to your wiki:
$ python pwb.py login
Χρήση σε τρίτα wiki
Το Pywikibot είναι προ-ρυθμισμένο για έναν μεγάλο αριθμό wiki, αλλά ενδεχομένως όχι για αυτό στο οποίο θέλετε να εργαστείτε. Δείτε το Manual:Pywikibot/Use on third-party wikis για το πώς να παραμετροποιήσετε το Pywikibot για το δικό σας wiki.
Περισσότερες επιλογές παραμετροποίησης
Το Pywikibot παρέχει μια ευρεία γκάμα από επιλογές παραμετροποίησης για να αλλάξετε τη συμπεριφορά του ρομπότ σας. Μπορείτε να αλλάξετε αυτές τις ρυθμίσεις στο αρχείο «user-config.py». Δείτε το config.py για μια λίστα με όλες τις παραμέτρους που μπορείτε να χρησιμοποιήσετε.
Proxy configuration
Pywikibot relies on requests for communicating with the web.
You can use HTTP_PROXY and HTTPS_PROXY environment variables to make requests use a proxy server.
Refer to requests' documentation for more info.
Εκτέλεση δέσμης ενεργειών
Το Pywikibot έρχεται πακέτο με έναν μεγάλο αριθμό από δέσμες ενεργειών στον κατάλογο scripts. Μπορείτε να τις εκτελέσετε όλες αυτές χρησιμοποιώντας
$ python pwb.py [name of the script]
To learn more about running basic Pywikibot scripts, see:
- Small wiki toolkits workshop about running basic Pywikibot scripts
- Self-study materials based on the small wiki toolkits workshop
- Workshop handbook based on the small wiki toolkits workshop
Μια λίστα όλων των δεσμών ενεργειών είναι διαθέσιμη στο $scripts.
Εξαρτήσεις
Οι περισσότερες δέσμες ενεργειών δεν απαιτούν πρόσθετα πακέτα, αλλά υπάρχουν μερικές που δεν δουλεύουν χωρίς κάποιο πρόσθετο πακέτο. Λίστα με αυτές τις εξαρτήσεις μπορεί να βρεθεί στο αρχείο requirements.txt.
Για να εγκαταστήσετε τις εξαρτήσεις, χρησιμοποιήστε το $pip, το οποίο θα πρέπει να είναι ήδη εγκατεστημένο εάν έχετε μια πρόσφατη έκδοση της Python. Εκτελέστε τις ακόλουθες εντολές για να εγκαταστήσετε πακέτα:
$ python -m pip install [name of the package]
Ή την παρακάτω εντολή για να εγκαταστήσετε όλα τα συνιστώμενα πακέτα:
$ python -m pip install -r requirements.txt
- If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel connect or pywikibot@ mailing list.