Manual:Pywikibot/Kurulum
Aşağıda, Pywikibot'u kendi bilgisayarınızda kurmanıza ve çalıştırmanıza yardımcı olacak bir kılavuz bulunmaktadır. Bu sürecin dört ana adımı vardır:
Python'u Yükle
Python'u https://www.python.org/downloads/'dan indirin ve yükleyin.
Make absolutely certain that you check the box at the bottom of the install wizard asking if you want to add Python to PATH!
That will allow you to access Python from any command prompt just by typing the keyword python.
Python'u zaten yüklediyseniz, bir konsolda python --version çalıştırarak sürümünüzün yeterince yeni olup olmadığını kontrol edin.
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, but Python 3.8 or higher is recommended. Windows'ta, Python ve pip'in düzgün çalışması için lütfen PATH ortam değişkenini değiştirmeyi unutmayın.
Gereksinimleri yükle
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'u kurun
$ python -m pip install pywikibot
If using pip, use pwb instead of python pwb.py in examples below.
Mevcut Pywikibot stable'i indirin: .tar.gz, .zip.
İndirilen dosyayı, örneğin ~/pywikibot'i %USERPROFILE%\pywikibot içinde paketinden çıkarın.
Alternatif olarak, Gerrit'ten git veya svn istemcisi kullanarak en son sürümü alabilirsiniz, bkz. Manual:Pywikibot/Gerrit#For users. Bu, aktif bot operatörlerinin ve geliştiricilerinin Pywikibot'u kullanması için önerilen yoldur.
Diğer sürümler https://pywikibot.toolforge.org/'da mevcuttur.
Pywikibot'u Güncelleme
Bot sürümünüzü güncel tutun. Sürekli olarak yeni sürümler yayınlanır ve aynı yerde bulunur.
Git veya svn sürümü kullanıyorsanız bu notu atlayabilirsiniz. Aksi takdirde, lütfen yapılandırma dosyalarınızı ve komut dosyalarınızı (user-config.py, oluşturmuş veya değiştirmiş olabileceğiniz herhangi bir aile dosyası veya özel komut dosyası ve bir wiki için kullanmakta olduğunuz herhangi bir geçerli XML döküm dosyasını yedeklemeniz gerektiğinin farkında olun.) yeni bir sürüm yüklemeden önce.
Yeni dosyaları eskisinin üzerine yazarak yeni sürümü eski sürüm üzerine kurun.
Pywikibot'u Yapılandır
Unix benzeri (Linux/BSD/Solaris) üzerinde "Terminal"i veya Windows'ta "Komut İstemi"ni açın (genellikle "Tüm uygulamalar"da "Windows Sistemi" veya "Aksesuarlar" klasörleri altında veya Başlat menüsündeki Tüm programlar menüsü) ve dizini Pywikibot'u paketinden çıkardığınız yere değiştirin:
- Unix benzerleri (Linux/BSD/Solaris):
$ cd ~/core
- Windows:
$ c: $ cd "%USERPROFILE%\pywikibot"
Pywikibot'u paketinden çıkardığınız yeri değiştirin.
Kullanıcı yapılandırma dosyası oluşturmak için aşağıdaki komutla devam edin:
$ python pwb.py generate_user_files
Pywikibot'u yapılandırmak için yönergeleri izleyin.
Son olarak wikinize giriş yapmak için aşağıdaki komutu çalıştırın:
$ python pwb.py login
Üçüncü taraf wikilerde kullanın
Pywikibot, çok sayıda wiki için önceden yapılandırılmıştır, ancak muhtemelen üzerinde çalışmak istediğiniz wiki için değil. Wiki'niz için Pywikibot'u nasıl yapılandıracağınızı öğrenmek için $üçüncü taraf konusuna bakın.
Daha fazla yapılandırma seçeneği
Pywikibot, botunuzun davranışını değiştirmek için çok çeşitli yapılandırma seçenekleri sunar. Bu ayarları user-config.py dosyasında değiştirebilirsiniz. Kullanabileceğiniz tüm parametrelerin listesi için config.py'ye bakın.
Proxy yapılandırması
Pywikibot, web ile iletişim kurmak için $request'leri kullanır.
İsteklerin bir proxy sunucusu kullanmasını sağlamak için HTTP_PROXY ve HTTPS_PROXY ortam değişkenlerini kullanabilirsiniz.
Daha fazla bilgi için istek' belgelerine bakın.
Bir komut dosyası çalıştırın
Pywikibot, "scripts" dizininde çok sayıda komut dosyasıyla birlikte gelir. Bunların hepsini aşağıdakileri kullanarak çalıştırabilirsiniz:
$ 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
Tüm komut dosyalarının bir listesi $scripts adresinde mevcuttur.
Diğer bağımlılıklar
Çoğu komut dosyası ek paketler gerektirmez, ancak bazıları gerektirir. Bunlar, bağımlılıklarıyla birlikte requirements.txt içinde listelenir.
Bazı betiklere bağımlılık yüklemek için pip kullanın ve aşağıdaki komutu çalıştırın:
$ python -m pip install [name of the package]
Alternatif olarak, tüm komut dosyaları için tüm bağımlılıkları bir kerede yüklemek için aşağıdaki komutu çalıştırın:
$ python -m pip install -r requirements.txt
- Pywikibot'unuzu ayarlamak için daha fazla yardıma ihtiyacınız olursa, #pywikibot IRC kanalı bağlan veya pywikibot@ posta listesi adresine ziyaret edin.