Manual:Pywikibot/PAWS/ur

اس دستاویز میں نوٹ بک کے ذریعہ پائی ویکیپیڈیا کے استعمال کا خاکہ پیش کیا گیا ہے، یہ نوٹ بک ویکیمیڈیا لیبز پر ہوسٹ کی گئی ہے جو 'PAWS' (Pywikibot: A Web Shell) استعمال کرتا ہے۔

ویکیمیڈیا کھاتہ بنائیں
اس طریقہ کار کی پیروی کرنے کے لیے ویکیمیڈیا منصوبہ پر آپ کا کھاتہ ہونا ضروری ہے۔

ویکیمیڈیا کھاتہ بنانے کے لیے لاگ ان کا صفحہ معاونت ملاحظہ فرمائیں۔ (خصوصی حروف اور علامتیں استعمال نا کریں، جب تک T120066 درست نا ہو جائے۔)

کھاتہ بن جانے کے بعد https://test.wikipedia.org/ پر جائیں اور اوپر دائیں جانب اپنا نام جانچیں۔

نوٹ بک میں سائن ان
ہوسٹ کردہ نوٹ بک شروع کرنے کے لیے https://tools.wmflabs.org/paws پر جائیں۔

"Sign in with MediaWiki" پر کلک کریں، بعد ازاں جب "Use OAuth for Authentication" کی اجازت مانگی جائے تو "Allow" پر کلک کریں۔

پہلی مرتبہ جب آپ PAWS میں رسائی حاصل کریں تو آپ کو ایک سرور بنانا پڑے گا۔

سرور کی تخلیق مکمل ہوتے ہی آپ https://tools.wmflabs.org/paws/user/ /tree جیسے کسی ربط پر پہنچ جائیں گے۔

ٹرمینل شروع کریں
نیا تعاملی ٹرمینل شروع کرنے کے لیے،
 * 1) اپنے PAWS کے سرورق پر جائیں
 * 2) دائیں جانب موجود 'New' پر کلک کریں، اور
 * 3) 'Terminal' منتخب کریں۔

اس کے بعد https://tools.wmflabs.org/paws/user/ /terminals/1 ربط کے ساتھ ایک نیا دریچہ کھلے گا، جس میں لینکس کا '$' پرامپٹ نظر آئے گا۔

آپ اس ربط کو بک مارک کر سکتے ہیں، اور کسی بھی وقت ٹرمینل پر واپس آسکتے ہیں، حتی کہ اگر آپ اپنا براؤزر یا کمپیوٹر بند کر دیں اس کے بعد بھی آپ اس ٹرمینل پر واپس آ سکتے ہیں۔

یہ ٹرمینل کوئی ایمیولیٹر نہیں ہے۔ یہ حقیقی بیش شیل ہے جو ڈوکر کنٹینر میں واقع حقیقی لینکس تنصیب کے ایک جز کے طور پر نصب ہے، چنانچہ آپ کسی بھی بیش کمانڈ کو استعمال کر سکتے ہیں، نیز لینکس پر نصب شدہ دیگر دستیاب کمانڈز بھی استعمال کیے جا سکتے ہیں۔

کچھ دستیاب کمانڈزدیکھنے کے لیے  کمانڈ استعمال کر سکتے ہیں۔

ویکی میں لاگ ان
پائی ویکی بوٹ میں ایک کانفیگریشن فائل 'user-config.py' درکار ہوتی ہے جو PAWS خودکار طور پر آپ کے لیے تخلیق کرتا ہے، اس فائل میں https://test.wikipedia.org/ ڈیفالٹ ویکی کے طور پر استعمال ہوگا۔

درج ذیل کمانڈ اس بات کی تصدیق کرے گی کہ آپ https://test.wikipedia.org/ میں لاگ ان ہو سکتے ہیں۔ یہ OAuth کا استعمال کرتا ہے، لہذا پاسورڈ درج کرنے کی ضرورت نہیں ہے۔

تخلیق صفحہ
نیا صفحہ بنانے کے لیے ٹرمینل میں درج ذیل کمانڈ درج کریں، اس کمانڈ میں موجود ' ' کو اپنے صارف نام سے تبدیل کر دیں اور جب آپکی تبدیلیوں کو قبول کرنے کی درخواست کی جائے تو 'Y' دبائیں۔

اب آپ ویکی میں ترمیم کر چکے ہیں۔ اپنی تبدیلیوں کو دیکھنے کے لیے اپنے براؤزر میں https://test.wikipedia.org/wiki/User_talk: ربط کھول سکتے ہیں۔

ان کمانڈ لائن اسکرپٹس کے متعلق مزید تفصیلات پڑھنے کے لیے '-help' کمانڈ لائن آپشن استعمال کر سکتے ہیں۔

صفحہ لائیں
Fetching many pages is achieved with the "listpages" command.

To get the contents of the page you created in the previous section, enter the following command:

Now if you go to your PAWS files list, the saved page should be present.

حقیقی اسکرپٹ نمونہ
When a website used on Wikipedia changes its URL, the links on Wikipedia become outdated, and possible also dead links if the website doesn't redirect from the old URLs to the new URLs. e.g. for example, Encyclopedia Britannica (EB) has changed their links, such as moving pages from http://www.britannica.com/EBchecked/media/ to http://www.britannica.com/topic/[topic name]/images-videos/*. You can find the list of usages of the old URL on English Wikipedia at https://en.wikipedia.org/wiki/Special:LinkSearch/http://www.britannica.com/EBchecked/media. Updating all those links manually will be very time consuming. Thankfully EB has maintained redirects from their old URLs to the new URLs, so this does not need to be fixed immediately.

For a simpler example, English Wikipedia currently contains links to http://britannica.com/EBchecked/ instead of http://www.britannica.com/EBchecked/ ; i.e. a 'www.' subdomain is missing in the URL.

There are currently 14 cases on English Wikipedia: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia in other language also have this problem. e.g. there is one case on German Wikipedia: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

In order to fix those links, we can use Pywikibot replace.py script. In this demo we will use the '-simulate' argument to avoid writing to the wiki, as there are strict rules about automated editing of English Wikipedia.

First lets list all of the pages which link to http://britannica.com/EBchecked/.

Now we check those pages actually have the literal URL in the page; i.e. they are not using a template.

Now use replace to add the missing "www."

In PAWS, and any terminal that supports color, the diff of changes will show the added "www." in green text color, making it easier to find the proposed changes.

پائی ویکی بوٹ میں
اس کے بعد ہم PAWS کی پائیتھون نشست استعمال کریں گے۔


 * 1) اپنے PAWS سرورق پر جائیں،
 * 2) دائیں جانب موجود 'New' پر کلک کریں، اور
 * 3) 'Python 3' منتخب کریں۔

اب نیا دریچہ کھل جائے گا۔

خانہ ترمیم میں ذیل میں موجود متن درج کریں اور Cell منیو سے 'Run' منتخب کریں (یا shift+enter دبائیں)

نیچے نیا خانہ ترمیم کھل جائے گا۔ APISite object جو https://test.wikipedia.org/ سے مربوط ہو، کو تخلیق کرنے کے لیے درج ذیل متن درج کریں۔

اب نئے خانہ ترمیم میں "site" درج کریں اور "Run" پر کلک کریں۔

اب ایسا ظاہر ہونا چاہیے

Out[3]: APISite("test", "wikipedia")

صفحہ آبجیکٹ بنائیں:

موجود ہے یا نہیں اسے جانچیں:

اب اس طرح ظاہر ہونا چاہیے

VERBOSE:pywiki:Found 1 wikipedia:test processes running, including this one. Out[5]: True

صفحہ پر موجود متن دکھائیں:

آبجیکٹ میں موجود متن صفحہ کو تبدیل کریں:

ویکی میں صفحہ محفوظ کریں:

اب جواب اس طرح ہوگا:

The interactive Python 3 notebook allows many lines to be run together. The above could be put into one text box and Run

The log of your interactive Python session can be saved or downloaded for future reference.

PAWS کے ذریعہ آن لائن دستاویزوں تک رسائی
Pywikibot documentation may be found at https://doc.wikimedia.org/pywikibot/index.html. It is primarily sourced from docstrings, which can be loaded in the interactive Python 3 notebook using the Python built-in function help.

For example, to look at the arguments for the save method above, run either:

or

پائی ویکی بوٹ اسکرپٹس میں ترمیم
پائی ویکی بوٹ کا کتب خانہ اور اسکرپٹس /srv/pwb میں رکھی گئی ہیں اور یہ ریڈ آنلی ہیں۔ پائی ویکی بوٹ کے نصب شدہ کتب خانہ میں PAWS کے ذریعہ ترمیم نہیں کی جا سکتی۔

البتہ ان اسکرپٹس کو PAWS میں پیسٹ کرنے کے بعد ان میں ترمیم کی جا سکتی ہے۔

To run a modified "checkimages.py"
 * 1) In the terminal, enter "cp /srv/pwb/scripts/checkimages.py ~"
 * 2) Click on the file checkimages.py in your PAWS home
 * 3) Edit the code and save your modifications
 * 4) In the terminal, enter "pwb.py ~/checkimages.py -simulate"