Extension:Genealogy
Genealogy リリースの状態: 安定 |
|
---|---|
実装 | パーサー関数 |
説明 | Adds a parser function for easier linking between genealogical articles. |
作者 | Sam Wilson (samwilsonトーク) |
最新バージョン | 2.4.0 (2023-03-09) |
互換性の方針 | master は後方互換性を維持しています。 |
MediaWiki | >= 1.39 |
データベースの変更 | いいえ |
Composer | samwilson/mediawiki-extensions-genealogy |
ライセンス | GNU 一般公衆利用許諾書 3.0 以降 |
ダウンロード | README.md |
例 | Demo wiki on Toolforge |
四半期ごとのダウンロード数 | 8 (Ranked 123rd) |
translatewiki.net で翻訳を利用できる場合は、Genealogy 拡張機能の翻訳にご協力ください | |
問題点 | 未解決のタスク · バグを報告 |
The Genealogy extension adds a parser function that makes it easy to link between genealogical articles. Basically, for any biographical article which links to other family members, the reverse link on those other articles can be created automatically.
You can experiment with it on Toolforge.
インストール
Note that you also need to install the Mermaid or Diagrams extension if you want to use the tree-drawing feature.
Install with Composer
The easiest way to install this extension is with Composer. Add this to your composer.local.json
file:
{
"require": {
"samwilson/mediawiki-extensions-genealogy": "^2.0"
}
}
Then run composer update
.
After that, you can enable the extension by adding the following to your LocalSettings.php file:
wfLoadExtension( 'Genealogy' );
Normal installation method
- ダウンロードして、ファイルを
extensions/
フォルダー内のGenealogy
という名前のディレクトリ内に配置します。
開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Genealogy - 以下のコードを LocalSettings.php ファイルの末尾に追加します:
wfLoadExtension( 'Genealogy' );
- 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。
使用法
This extension creates one parser function: {{#genealogy: … }}
.
Its first first parameter is unnamed (i.e. doesn't have an equals sign) but all others are.
The following parameters are supported, three for defining data (♦) and four for reporting data (♦):
- ♦ Define and output a link to a parent:
{{#genealogy:parent|Page Name Here}}
- ♦ Define a partner (no output produced; use
partners
to list):{{#genealogy:partner|Page Name Here}}
- ♦ Define a page's description (see below for what that means):
{{#genealogy:description|Some description}}
A page's description is a date range or short phrase that will appear in places next to page titles to give them some more context. For example, under people's names in the tree output. - ♦ List all siblings:
{{#genealogy:siblings|exclude_self=yes}}
Whereexclude_self
optionally excludes the current page from the resulting list. - ♦ List all partners:
{{#genealogy:partners}}
- ♦ List all children:
{{#genealogy:children}}
- ♦ Display a tree (a connected graph):
{{#genealogy:tree|ancestors=List|descendants=List|delimiter=char|format=formatname}}
where eachList
is adelimiter
-separated list of page titles, andformatname
is 'graphviz' or 'mermaid' (not case sensitive). This requires the Mermaid , GraphViz , or Diagrams extension. The delimiter is a newline by default (i.e. each page title should appear on it's own line).
テンプレート
Example: For an example template that makes use of these parser functions, see person_template.wikitext.
Preload:
When this extension creates a link to a page that doesn't yet exist,
the text of [[Template:Person/preload]]
is preloaded.
The location of this preload text can be customised
by modifying the genealogy-person-preload
system message.
Person list-item:
Three types of lists of people can be generated: siblings
, partners
, and children
.
The default behaviour is a simple bulleted list,
but this can be overridden by a template, Template:Person/list-item
(the template name is specified by the genealogy-person-list-item
system message).
For example, to get a comma-separated one-line list of people, the following template code could be used:
{{{link}}}{{#if: {{{description|}}} | ({{{description}}}) }}{{#ifeq:{{{index}}}|{{{count}}}|.|,}}
There are six parameters that are available for use in the list-item template:
link
— A wikitext link.title
— The full page title, including namespace.pagename
— The page name, without namespace.description
— The page description.index
— The index of this list-item in the full list, starting from 1.count
— The total number of items in the full list.
開発
This extension was built by Sam Wilson and released under version 3 of the GPL (see LICENSE.txt for details).
Please report all bugs to the #Genealogy project on Phabricator.
関連項目
この拡張機能は以下のウィキ ファーム/ウィキ ホスト/パッケージに含まれています: これは正式な一覧ではありません。 一部のウィキ ファーム/ウィキ ホスト/パッケージは、ここに記載されていなくてもこの拡張機能を含んでいる場合があります。 必ずご利用のウィキ ファーム、ウィキ ホスト、バンドルで確認してください。 |