User:Tp61i6m42008/AWB
使用AWB進行工作時,必須確保您的操作不危害社群及不違反共識,且您對您的操作完全負責。 請務必了解維基百科的方針與指引,並且在方針與指引許可的範圍內使用本工具。 如果您無法做到以上要求,請停止使用本工具。如有疑問,請到互助客棧發起討論。 |
原作者 | Bluemoose (退休) |
---|---|
開發者 | 自動維基瀏覽器 團隊 |
编程语言 | C# |
操作系统 | Microsoft Windows |
语言 | 英文 |
类型 | Wikipedia 編輯工具 |
许可协议 | GPL v2 |
网站 | sourceforge (如果該網站無法訪問,嘗試 here) |
自动维基浏览器(简称AWB)是一種半自動的MediaWiki編輯器,為Microsoft Windows 2000/XP/Vista/7使用者在需要大量重複編輯時提供方便。(它在Linux下的Wine亦可以運作,但這並非官方支援)它實際上是一個瀏覽器,在首頁面成功儲存後會自動打開新頁面。當使用此權時, 它表明著一些變化 (通用格式) ,一般都要附帶主要的變化。
現在AWB可創建來自一個或多個分類、鏈入頁面、頁面上維基鏈接、文本文檔、google搜索、用戶監視列表或用戶貢獻的頁面的列表。AWB还配备了一个扫描维基百科数据库转储的综合方案。AWB的編輯框支持微軟Text Services Framework 用於語音/手寫識別。
本软件源代码是基于GPL发布(详见获得源代码),本软件是以C#编写而成,其编译器Microsoft Visual C# Express Edition/Visual Studio能在这里获得,这里为AWB的IRC讨论组irc.freenode.net — #AutoWikiBrowser。
需要AWB协助工作的例子已列出在计划页中(中文这里暂没列出,英文的请看这里),同时这里也列出需要AWB帮助完成的计划。
用户组 | 用户数 |
---|---|
管理員 | 63 |
机器人 | 7 |
一般用戶 | 59 |
使用規則
- Check every edit before you save it. Make sure you understand the text and have NOT changed the meaning (unless that was your explicit intent).
- Don't edit too quickly; consider opening a bot account if you are regularly making more than a few edits a minute.
- Don't do anything controversial with it. If there is a chance that the edits you are considering might be controversial, consider soliciting comment at the village pump or appropriate WikiProject before proceeding.
- Avoid making insignificant or inconsequential edits such as only adding or removing some white space, moving a stub tag, converting some HTML to Unicode, removing underscores from piped links, bypassing a redirect, or something equally trivial. This is because it wastes resources and clogs up watch lists. With some exceptions (such as changes to the emitted metadata or categorization of the page), an edit that has no noticeable effect on the rendered page is generally considered an insignificant edit. If in doubt, or if other editors object to edits on the basis of this rule, seek consensus at an appropriate venue before making further edits.
- Abide by all Wikipedia guidelines, policies and common practices.
- The Wikipedia tenet "be bold" is not a justification for mass editing lacking demonstrable consensus. If challenged, the onus is on the AWB operator to demonstrate or achieve consensus for changes they wish to make on a large scale.
概略
AWBは、記事を投稿すると自動的に新しいページが開かれます。必要な設定を行えば、主な編集とともにしなければならない細部の編集(一般的にスタイルの調整)を提案する機能を使用することができます。ただし、使用できないプロジェクトもあるため注意が必要となります。[1]
現在、AWBは、1つまたは複数のカテゴリ、「リンク元」、Googleの検索結果、ウォッチリスト、投稿記録などから記事のリストを生成することができます。 また、データベースをスキャンするプログラムとIRCMonitor(IRCの最近更新されたページをモニタリングするプログラム)の開発バージョンが付属しています。
AWBのソースコードはGPLの下で入手できます。詳細については#ソースを入手するにはを参照のこと。AWBはMicrosoft Visual C# Express Edition[2][3]を用いてC#で書かれています。
AWB使用時のルール
- 投稿する前に必ず毎回編集内容をチェックすること。編集前の文章の内容をよく理解し、文脈、内容が変わらないように気をつける必要があります。
- あまりにも短時間で、大量の投稿をしないようにする。最低でも30秒は間隔を置くようにしてください[5]。
- 論争になるようなことは一切行わないようにする。
- 無意味な編集や取るに足らない編集はしない。たとえば、空白を追加・除去する、スタブタグを移動させる、リンクを除去する[6]、などの編集を指します。これらの編集はリソースを浪費し、ウォッチリストを埋めてしまうため、推奨されていません。
- すべてのガイドライン、方針、慣例を遵守すること。
これらの規則に反する行為を行うと、予告なしでAWBの使用ができなくなることがあるので、注意が必要です。
使用方法
以下に、使用方法を順に説明します。
登録
英語版ウィキペディアやコモンズでAWBを使用したい場合はRequests for registrationにユーザ名を追加する必要があります。安全上の理由により、英語版では登録したユーザ[7]のみAWBを使用することができるようになっているためです。ただし、日本語版では登録をする必要はありません。
Requests for registrationにユーザ名を追加することにより誰でも登録はできますが、使用するには管理者による承認が必要となります。承認されるには、標準名前空間の編集回数が500回以上というのがおおよその目安となります。登録が承認された際、管理者から通知が行われることは、あまりないため、自分で定期的に登録ページをチェックすることをおすすめします。
ダウンロード
AWBはSourceForgeからダウンロードできます[8] 最新版のSVNバージョンを動作させたい場合は、#ソースを入手するにはを参照のこと。
インストール
ダウンロードしたファイルを、任意の場所に解凍するだけで使用できるようになります[9]。
OS | Microsoft Windows 2000/XP以降のWindows OS Windows 98/Meでは正常に作動しない |
---|---|
その他 | .NET Framework(Ver.2.0以降) Windows Vista以降のOSでは標準でインストールされているためインストールは不要 |
もし正常に動作しない場合、正しく登録されているか、.NET Frameworkが正しくインストールいるか確認してください。
使用方法
- 画面左下の「(1) Make list」から「Make from Category」を選択し、その下にカテゴリの名前を入力します。
- 「Make list」をクリックし、記事のリストを読み込ませます。
- 検索、置換、要約欄などのオプションを設定します。
- 「Start the Process」をクリックすると、記事の読み込みが行われ、編集が開始されます。また、画面には差分が表示されます。
- 画面右下の編集ボックスで必要な編集を行い、「Save」か「Ignore」をクリックします。「Save」をクリックすると編集内容が投稿され、「Ignore」をクリックすると編集内容は無視されます。どちらのボタンを押しても自動的に、次のページが読み込まれます。
既知の問題
- ページを読み込む際に動作が停止することがあります。主な原因としては、AWBとは別のウィンドウをアクティブにしたためというものがあります。AWBは新しいページを読み込むときにはAWBのウィンドウをアクティブにしておく必要があるため、動作が止まったときは再度「Start the Process」をクリックしてください。
- AWBはInternet Explorer(以下、IE)のコンポーネントを使用しているため、何かトラブルがあった場合はIEが正しく動作しているかを確認すること。また、IEを使用してウィキペディアにログインしているかどうかも確認すること。スクリプトについての設定を変更している場合は、IEのツールバーの「インターネットオプション」→「詳細設定」タブ→「リセット」をクリックしてみてください。
- monobook.cssにCSS 2・3を必要とする編集を行っている場合、それらがIEやAWBに正しく表示(反映)されない可能性があります。
- 「リンク元」からリストを作成していてトラブルが発生した場合、IEキャッシュのクリアを試してみてください。
- バグの出る monobook.jsを使用していると、しばしばIEで画面が真っ白になったりAWBがクラッシュしたりします。このトラブルは、IEの「インターネットオプション」→「セキュリティ」タブ→「レベルのカスタマイズ」でアクティブスクリプトを無効にすることで回避できます。
- 「The application failed to initialize properly...」というメッセージが表示された場合は.NET Framework 2.0をインストールしてください。
詳細や確認されているバグ、その他のソフトウェアやウィキペディアの外装についてはen:Wikipedia talk:AutoWikiBrowser#Frequently asked questionsを参照のこと
説明書
使い方の詳細は以下のページを参照してください。
- Wikipedia:AutoWikiBrowser/作業手順 - 具体的な作業手順の説明
- Wikipedia:AutoWikiBrowser/説明書- 各ボタンの詳細な説明
データベーススキャナ
AWBには、ウィキメディアのサーバに不必要な負担をかけずにチェックする記事のリストを生成する、データベーススキャナが実装されています。
データベースダンプはしばしば作られ、無料でダウンロードできます。ページの状態の確認用として、最も役に立つダンプはpages-articles.xml.bz2です。database dump progress site(日本語版用)にアクセスすると、現在のダンプ状況を見ることができ、簡単にダウンロードできます。
ダウンロードしたファイルを使用する際には、アーカイブを解凍する必要があります。解凍すると3GBのbz2アーカイブは12GBのXMLデータベースダンプとなるため、ディスクの空き容量に注意してください。
API
AWBは他のスタンドアロンプロジェクトから参照できるWikiFunctions.dllを同梱しています。このDLLはwiki-ready web browser control、シンプルページエディタ、リストメーカー、その他のツールなどを含んでいます。
プラグイン
AWBはカスタムプラグインを組み込んで使用することができます。それらのプラグインは記事を処理したり、ユーザインタフェースを拡張したりすることができます。またプラグインはC#やVisual Basic.NETのような.NET言語で作ることのできるDLLファイルの形で存在します。AWBの起動時には、AWBがあるフォルダにプラグインがないか自動的にチェックされます。検出されたプラグインはユーザが特に何もしなくても自動的に読み込まれ初期化されます。
便利な使い方
- 大文字と小文字を検索・置換するには、正規表現を使用します。
- 誤字の修正などで作業の速度を上げるには、「Skip if doesn't contain」を設定します(修正された文字を入力する)。
- .NET正規表現構文については[1]を参照のこと。
- ウィキペディアのサーバの応答が遅いときにInternet Explorerの「インターネットオプション」で「画像を表示する」のチェックを外すとページの表示スピードが速くなります。また、通常、IEを使用せず、他のブラウザでカスタムされたmonobook.jsを使用している場合は、「インターネットオプション」→「セキュリティ」タブ→「レベルのカスタマイズ」でアクティブスクリプトを無効にすることで、ページ表示が高速化される可能性があります。
- Windows Updateを手動に設定している場合は、アクティブスクリプトを有効にする必要があります[10]。
- 役に立つ設定の一覧については、en:Wikipedia:AutoWikiBrowser/Settingsを参照。
- 検索・置換をする場合、改行は
\r\n
と表します。[11] - AWBでは、テキストボックスと検索・置換ダイアログ内でキーワードが使用できる。たとえば
%%title%%
は記事のタイトルを表します(例:"John Smith")。また、%%key%%
はカテゴリのソートキー(人名に限る)を表します(例:"Smith, John")。他のキーワードについてはリクエストにより提供する。
(使用・設定方法については割愛します。)
ソースを入手するには
AWBはGPLに準拠しています[12]、ソースを入手するには、SVNクライアントプログラムを使用してsourceforgeにアクセスする必要があります。
クイックガイド
以下に、TortoiseSVNを使用する例を示します。
- TortoiseSVNをインストール。
- インストール終了後、「AWB」(任意の名前でも可)というフォルダを作成する。
- 作成したフォルダを右クリックし、「SVN Checkout...」を選択する。
- (titled "Checkout")と表示されているダイアログウィンドウの、URL of Repositoryと書かれたところにhttps://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowserと入力する。
- 下のディレクトリが正しいかどうかをチェックする。
その後、Sourceforge SVNサーバからソースを入手できるようになります。新しいソースが入手可能になった場合、AWBが入っているフォルダのコンテキストメニューから「SVN Update」を実行する。新しいバージョンについては自動的に通知されるわけではないため、定期的にAWBを使い、新しいソースバージョンを使用するなら、毎日チェックする必要がある。もし変更があれば、新しくリリースされたバージョンをビルドします。
SVN Updateを実行するとき、ソフトウェアは更新履歴を確認し、必要と思われる新しいファイルをダウンロードします。ダウンロード前に現在AWBフォルダにあるファイルをチェックし、必要なファイルのみが自動的にダウンロードされます。
最新のバージョンを実行するために、ソースを使いたい場合、これらを自分でコンパイルする必要があります。その際、Microsoft Visual C# Express Edition、または、Visual Studio 2005の上位バージョン(例:Professional)が必要となります。コンパイルの方法については、使用するIDEのマニュアルを参照してください。
もし、コマンドラインSVNがインストールされているなら、キーボードからの入力によって作業することもできます。。
コマンドプロンプトに次のように入力します。
- デフォルトの場所(「autowikibrowser」というフォルダ)を使用する場合。
- svn co https://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowser
- デフォルト以外の場所を使用する場合以外を使用する場合。
- svn co https://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowser FILE_PATH
- FILE_PATHのところを指定したい場所のパスで置き換えてください。
すべてのSVNの更新履歴はSVN Revision Logで見ることができます。
Having problems?
- Occasionally it stalls when loading. This might well be because you have navigated to a different window: AWB needs to remain in the foreground while loading up a new page. Just click "start" again to give it a nudge.
- It uses the Internet Explorer core, so if you have problems, make sure your IE is working. Make sure you have logged into Wikipedia using IE. If you have altered any settings regarding scripts, first use Tools > Internet Options > 'Advanced' tab > Click on 'Restore Defaults' and then try AWB again.
- If you have made changes to monobook.css (or whatever your theme is) that require CSS 2 or 3, they may not appear properly in IE and thus in AWB.
- If you are having problems creating a list from "what links here" try clearing your Internet Explorer cache.
- A buggy monobook.js can often cause IE to display blank pages or crash AWB. This javascript problem can be avoided by disabling Active Scripting in IE INTERNET OPTIONS — SECURITY — CUSTOM LEVEL.
- "The application failed to initialize properly..." -> get .NET 2.0 (linked above).
Refer to the FAQ for more information, including problems with other software and Wikipedia skins.
User manual
Database scanner
AWB includes a database scanner which can be used to create lists of pages to be checked, without causing extra unnecessary load on Wikimedia servers.
Database dumps are created from time to time (more info here) and are available for free download. As the page states, the best/most useful dump is the pages-articles.xml.bz2. Visiting the database dump progress site, allows you to view the status of the current dump, and be able to easily browse to the downloads in it.
After downloading, the archive needs to be uncompressed; this will turn it from a ~7.5 GB bz2 archive into an xml database dump around 33 GB.
A scannable .xml file can also be generated by visiting Special:Export.
API
- AWB ships with WikiFunctions.dll, which can be referenced by other standalone projects. The DLL includes a wiki-ready web browser control, a simple page editor, a listmaker, and other tools and components.
Plugins
AWB is able to load and use fully customised plugins. These plugins can process page text and extend the user interface, and are in the form of libraries (.dll files) which can be made in any .NET language such as C# or Visual Basic .NET. When AWB loads, it automatically checks to see if there are any plugins in the folder it was executed from. Any plugins found are loaded and initialised without further intervention by the user.
Tips and tricks
- To find and replace a word of upper and lower case, do a regular expression find and replace; for example, find: "\b([Tt])hier\b" and replace with: "$1heir". The "[Tt]" matches upper or lower case "t", the "$1" references whatever "[Tt]" matches. The "\b" indicates a word boundary; this prevents words like "clothier" from matching. The "(..)" marks the section or 'clause' that the "$1" is to replace.
- To speed up a task, if you are correcting the above typo, set it to "Skip if doesn't contain" the typo(s) that is being corrected.
- See Regular Expressions in .NET for a breakdown of .NET regular expression syntax.
- See Wikipedia:AutoWikiBrowser/Settings for a list of useful settings you can use with AWB.
- AWB may have keywords that can be used in the textboxes/find-and-replace dialog. Currently, there is %%title%%, which represents the title of the current page (e.g. "John Smith"), and %%key%%, which will give you the human name category key for the current page (e.g. "Smith, John"). Other keywords can be implemented on request.
取得原始碼
此頁面提供原始碼下載。
AutoWikiBrowser is licensed under the GPL (see the license file).
Download source
To get the sources, you need read access to the SourceForge SVN server with an SVN client program.
TortoiseSVN
If you would like to use the latest source release, TortoiseSVN is recommended software, and a quick guide for which is included below.
After installing TortoiseSVN, create a folder AWB (or whatever name you prefer) and right click in the folder, and select "SVN Checkout...". In the dialog window that appears (titled "Checkout") enter https://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowser/AWB
for the field URL of Repository. Check that the directory beneath is correct. You should then get the sources from the SourceForge SVN server. This is a ~7 MB download. When new sources become available execute "SVN Update" from the context menu of your AWB folder. You are not automatically notified of new versions; if you use AWB on a regular basis, and want to use the source version, check this daily, and build a new release version if there are changes. That way you are up to date with all bug fixes and new features.
Please note that you cannot commit sources back to the SourceForge server by using this method (this is called "anonymous access" or "anon access" for short). You would need to be registered as a project developer for this.
When you execute a "SVN Update", the software will download a change list then check the files that are present in the AWB folder, before downloading any new or updated files that may be needed.
Command line
If you have command line SVN installed on your PC, it is as simple as typing svn co https://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowser/AWB
That would put it in a folder called autowikibrowser in the default location. If you wanted to specify a location to copy it to, you would append the command with the location, e.g. svn co https://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowser/AWB d:\pathtofile
Full repository
https://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowser/AWB
just gives you the AutoWikiBrowser project itself. The root https://autowikibrowser.svn.sourceforge.net/svnroot/autowikibrowser
is where tags, branches, and the Usage Stats and TypoScan project files are. Most people will neither want nor need those.
Compile source
If you would like to use the sources to run the latest source version, you will need to compile these yourself. You will need a copy of Microsoft Visual C# Express Edition, or a more complete version of the Visual Studio 2008 suite, such as Professional, or a third-party C# IDE such as SharpDevelop (free).
Visual Studio
Browse to the second AWB folder, and run the Visual Studio Solution. When the IDE has loaded, select release rather than debug (next to the green forward arrow). On the solution explorer on the right hand side, right click on the solution, and select build solution. Visual Studio will now turn the source files into the required files to run AWB. Back in the AWB folder, browse to bin\release, and copy AutoWikiBrowser.exe and WikiFunctions.dll from the folder to where you run AWB from.
SharpDevelop
Open the "AutoWikiBrowser no plugins" solution file. Right click on the AutoWikiBrowser project on the left hand side and set it as the startup project. Press F8 to build AWB. The AWB executable will be placed in ...\AWB\AWB\bin\
then a subfolder depending on whether you build a release or debug build (release recommended if you just want to use the latest version of AWB).
Changes to AWB code
You can view all SVN changes in the SVN Revision Log.
Snapshots
If you would like to use more up to date SVN versions, but are unable to build your own versions, User:Reedy (an AWB Developer), uploads periodic SVN release snapshots here.
使用自動維基瀏覽器
(1)註冊
欲於中文維基百科上使用此軟體,請至申請頁面申請自動維基瀏覽器使用權限,由於安全原因,僅限於註冊用戶申請。
英文維基百科:管理員和獲授權機器人無需批准,一般用戶則需編輯條目多於500次始可以使用。
中文維基百科:暫未有明確要求,主須可信。
Add your name to the requests for registration if you would like to use the software. For security reasons, only registered users (see the list on the check page) are able to use AutoWikiBrowser on the en.wikipedia.
Anyone can be registered, but only if an admin approves your registration by placing your name on the check page. As a general rule, only users with more than 500 mainspace edits will be registered. You will probably not be contacted when your registration has been approved, so check the page periodically for your name.
(2)下載
釋出版本(5.3.1.0版)可於此處下載,另可於此處下載最新開發版本,該檔案為ZIP檔案,建議解壓縮至檔案夾中使用,而非直接在壓縮檔中執行,而後點選AutoWikiBrowser.exe即可執行。
自动维基浏览器系統需求為Microsoft Windows 2000/XP或更新版本,Windows Vista/Windows 7亦可使用。
Download the release version here or alternatively you may download the latest development snapshot here. AWB comes in a zip file and it is recommended that it be unzipped to a new directory, rather than running, for example, straight from the desktop. AWB is not installed on the PC and runs only as a file: AutoWikiBrowser.exe.
If you want to run the latest SVN version, see here.
AutoWikiBrowser requires Microsoft Windows 2000/XP or newer (Unicode does not work properly on Windows 98/Me). It also requires Version 2 of the .NET Framework (users of Windows 2000 and Windows XP must download .NET Framework; it is included in Windows Vista and Windows 7).
If the software does not work, it probably means that you are not registered or that you do not have the correct .NET Framework installed.
On Linux, AWB partially works with Wine.[13] It can also be started (although with some strange errors), on Mono. See Mono and Wine. The installation process is the same as Wikipedia:Huggle/Wine.
(3)開始使用
- Select "Make from Category" then enter a category name.
- Click "Make list", let the list load up.
- Set any options, such as find and replace, edit summary, etc.
- Click "Start!", it will load up the page, automatically make any changes and then go to the diff.
- Change anything in the page you want in the Edit box on the lower right, not the normal website textbox in the browser, then click "Save" or "Skip / Ignore", the next page will load up automatically.
參見
- {{User wikipedia/AWB user}} – a userbox for displaying usage rights of the AutoWikiBrowser
- {{AWB topicon}} – a topicon for displaying usage rights of the AutoWikiBrowser
- IRCMonitor
- MWiki-Browser
相關項目
- Help:Pywikipediabot - CUIですが言語間リンク、外部サイト上の情報の取り扱い、スケジュールに応じた作業、などに特に強みを持つボットソフトです。AWBと違いWindowsに限らない非常に多様な環境で動作します。
- MWiki-Browser(英文)
- IRCMonitor(英文)
外部連結
- Project home on Sourceforge(英文)
- Browsing the sources on Sourceforge(英文)
- Regular Expression Language Elements - マイクロソフト MSDNドキュメント .NET Framework開発者ガイド(英文)
- Regular Expression Language Elements from the .NET Framework Developer's Guide in the online MSDN documentation of Microsoft.
- Repeated abuse of these rules could result, without warning, in your software being disabled.
註釋
- ^ ko:위키백과:사랑방/2008년 제30주#오토위키브라우저 사용에 관련해서(現在はウィキペディア韓国語版でも使用可能)
- ^ Microsoftの公式ページから無料でダウンロード可能
- ^ Microsoft Visual Studio Express Edition
- ^ irc.freenode.net - #AutoWikiBrowser
- ^ 短時間でより多くの規則的な編集を行いたい場合はボットアカウントの取得を考慮することをおすすめします。
- ^ en:Wikipedia:Bad linksを参照。
- ^ Check page参照
- ^ AutoWikiBrowser
- ^ デスクトップに直接解凍しても利用できますが、新しいフォルダを作ってその中に解凍することをおすすめします。
- ^ アクティブスクリプトがウィキペディアを利用しているときだけ無効になるように設定することも可能。
- ^ これはMicrosoftのコンポーネントによるもので、他のツールを使用している場合は異なる。たとえばFirefoxなら
\n
となる。 - ^ ライセンスファイル参照
- ^ Wine Application Database Entry for AWB