Jump to content

Extension:校对页面

本頁使用了標題或全文手工轉換
From mediawiki.org
This page is a translated version of the page Extension:Proofread Page and the translation is 65% complete.
MediaWiki扩展手册
Proofread Page
发行状态: 稳定版
实现 页面操作 , ContentHandler , 标签 , API , 数据库
描述 The Proofread Page extension can render a book either as a column of OCR text beside a column of scanned images, or broken into its logical organization (such as chapters or poems) using transclusion.
作者 ThomasV (original author)
Tpt (current maintainer)
最新版本 continuous updates
兼容性政策 快照跟随MediaWiki发布。 master分支不向后兼容。
MediaWiki current master
PHP 7.0+
数据库更改
Composer mediawiki/proofread-page
Page, Index
  • $wgProofreadPagePageSeparatorPlaceholder
  • $wgProofreadPagePageSeparator
  • $wgProofreadPageNamespaceIds
  • $wgProofreadPageUseParsoid
  • $wgProofreadPageEnableEditInSequence
  • $wgProofreadPageBookNamespaces
  • $wgProofreadPageUseStatusChangeTags
  • $wgProofreadPagePageJoiner

  • pagequality
  • pagequality-admin
  • pagequality-validate
许可证 GNU General Public License 2.0 or later
下載
帮助 Help:Extension:ProofreadPage
示例 s:Index:Wind in the Willows (1913).djvu
前往translatewiki.net翻譯Proofread Page扩展
問題 开启的任务 · 报告错误

Proofread Page extension

2020 Coolest Tool
Award Winner

in the category
Impact


Proofread Page擴充功能可創建一本書:

  1. 若不是,變成在一column掃瞄的影像旁邊的一columnOCR文字
  2. 那就是,被拆成數個的章節或段落,文件的內容會出現在MediaWiki頁面之中(透過嵌入)

这个扩展用于让对比文本和数字化原件更简单。

此擴充功能以多種方式顯示文字,但不需實際地複製原始文字。[1]

使用

此擴充功能被安裝在所有維基文庫的wiki。 有关语法,请参阅维基文库校對頁面的帮助文档。 它之前也被用在维基别库上。

需求和建議


安裝

扩展

  • 下载文件,并解压ProofreadPage文件夹到extensions/目录中。
    开发者和代码贡献人员应改从Git安装此扩展,输入:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ProofreadPage
    
  • 請新增下列代码到您的LocalSettings.php 文件的底部:
    wfLoadExtension( 'ProofreadPage' );
    
  • 請运行更新脚本,它将自动创建此扩展所必须的数据库表。
  • Yes 完成 – 請导航至您的wiki上的Special:Version,以验证此扩展已成功安装。

產生縮圖

該擴充功能可直接連結至那些時常是不存在的圖片縮圖。 您必須去捕捉404錯誤並產生遺失的縮圖。 您可以使用這些解決方案中的任何「一個」:

  • 設定Apache在.htaccess中的RewriteRule為thumb.php ,用於縮圖遺失的情況:
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^/w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/page([0-9]+)-?([0-9]+)px-.*$ /w/thumb.php?f=$1&p=$2&w=$3 [L,QSA]
  • 」將Apache 404處理器設定為Wikimedia的thumb-handler。 這是一個通用的404處理器,內含維基媒體專屬的程式碼,「並非」是一個單純的縮圖產生器。
    ErrorDocument 404 /w/extensions/upload-scripts/404.php
  • 對於MediaWiki >= 1.20,您可以簡單地重定向到thumb_handler.php:
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^/w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/page([0-9]+)-?([0-9]+)px-.*$ /w/thumb_handler.php [L,QSA]
  • 或在apache2.conf中:
    ErrorDocument 404 /w/thumb_handler.php
警告 警告: 在images目錄內有.htaccess檔案,可能會干擾您安裝的任何.htaccess規則。

如果您遇到類似以下的問題:

  • phab:T301291 – 維基共享資源上的PDF和DjVu檔案處理失敗(無縮圖、無頁面),但在其他方面有效
  • phab:T298417 – 未刪除的DjVu檔案顯示不正確的metadata: 0x0大小、無頁碼資訊
  • phab:T299521 – 在維基共享資源中,PDF檔案上傳新版本後的影像大小為0x0,而頁數卻是正確無誤

請尝试以下步骤:

  1. 修復核心MediaWiki中DjVu檔案的縮圖(PDF檔案請使用MIME類型 application/pdf
    php maintenance/refreshImageMetadata.php --verbose --mime image/vnd.djvu --force
    
  2. 用於實現Special:IndexPages頁面數的所需資訊
    php maintenance/refreshLinks.php --namespace 252
    

命名空間

預設情況下,ProofreadPage 會建立兩個自訂命名空間,名稱分別為英文的「Page」和「Index」,其ID分別為250和252。

如果您的維基使用其他語言,這些名稱將會被翻譯。 完整列表.

您可以自訂其名稱或其ID:手動建立命名空間,並透過 $wgProofreadPageNamespaceIds 全域變數在 Manual:LocalSettings.php 中設定其 ID。 操作方式類似以下:

define( 'NS_PROOFREAD_PAGE', 250);
define( 'NS_PROOFREAD_PAGE_TALK', 251);
define( 'NS_PROOFREAD_INDEX', 252);
define( 'NS_PROOFREAD_INDEX_TALK', 253);
$wgExtraNamespaces[NS_PROOFREAD_PAGE] = 'Page';
$wgExtraNamespaces[NS_PROOFREAD_PAGE_TALK] = 'Page_talk';
$wgExtraNamespaces[NS_PROOFREAD_INDEX] = 'Index';
$wgExtraNamespaces[NS_PROOFREAD_INDEX_TALK] = 'Index_talk';
$wgProofreadPageNamespaceIds = array(
    'index' => NS_PROOFREAD_INDEX,
    'page' => NS_PROOFREAD_PAGE
);

不建議自訂命名空間 ID,且此功能未來可能不再受支援。

配置

索引命名空間的組態

有关详细信息,请参阅Extension:Proofread Page/Index data configuration

此組態為一個由屬性組成的JSON陣列。 以下是陣列中屬性的結構,所有參數皆為可選,並已設定預設值:

{
  "ID": { //元資料的 ID(proofreadpage_index_attributes 的第一個參數)
    "type": "string", //屬性類型(基於相容性考量,值不一定要是此類型)。 可能的值:字串、數字、頁面。 <span lang="en" dir="ltr" class="mw-content-ltr">If set, the newly set values should be valid according to the type (e.g. for a number a valid number, for a page an existing wiki page...)</span>
    "size": 1, //only for the type string: number of lines of the input (third parameter of proofreadpage_index_attributes)
    "values":  {"a":"A", "b":"B","c":"C", "d":"D"}, //an array values : label that list the possible values (for compatibility reasons the stored values have not to be one of these)
    "default": "", //the default value
    "header": false, //add the property to MediaWiki:Proofreadpage_header_template template (true is equivalent to being listed in proofreadpage_js_attributes)
    "label": "ID", //the label in the form (second parameter of proofreadpage_index_attributes)
    "help": "", //a short help text
    "delimiter": [], //list of delimiters between two part of values. <span lang="en" dir="ltr" class="mw-content-ltr">By example ["; ", " and "] for strings like "J. M. Dent; E. P. Dutton and A. D. Robert"</span>
    "data": "" //proofreadpage's metadata type that the property is equivalent to
  }
}

The data parameter can have for value:

"type", "language", "title", "author", "translator", "illustrator", "editor", "school", "year", "publisher", "place", "progress"


Page separator

The extension puts a separator between every transcluded page and the next, which is defined by wgProofreadPagePageSeparator. The default value is &#32; (a whitespace). Set wgProofreadPagePageSeparator = "" to suppress the separator.

Join hyphenated words across pages

When a word is hyphenated between a page and the next, the extension joins together the two halves of the word. Example: his- and tory becomes history. The "joiner" character is defined by wgProofreadPagePageJoiner and defaults to - (the ASCII hyphen character).


Configure change tagging (optional)

See Change tagging to set up change tags.

用法

Creating your first page (example with DjVu)

  • Before following these steps ensure you have followed the instructions in Manual:如何在MediaWiki中使用DjVu .
  • (when and in which namespace is the DjVu file itself uploaded?)
  • Create a page in the "Page" namespace (or the internationalized name if you use a not-English wiki). For example if your namespace is 'Page' create Page:Carroll - Alice's Adventures in Wonderland.djvu
  • Create the corresponding file for this page commons:File:Carroll - Alice's Adventures in Wonderland.djvu (or set 手册:$wgUseInstantCommons to true).
  • Create the index page Index:Carroll - Alice's Adventures in Wonderland.djvu
    • Insert the tag ‎<pagelist /> in the Pages field to visualize the page list
  • To edit page 5 of the book navigate to 'Page:Carroll - Alice's Adventures in Wonderland/5' and click edit

語法

此扩展引入了以下标记: ‎<pages>, ‎<pagelist>

参阅

注释

  1. 由於這些頁面並不在主命名空間中,因此不會在文字單位的統計計數的涵蓋範圍內。