ՎիզուալԽմբագրիչ/Ծանոթագրության գործիք

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page VisualEditor/Citation tool and the translation is 68% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Cymraeg • ‎English • ‎Tiếng Việt • ‎Türkçe • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎italiano • ‎português • ‎português do Brasil • ‎slovenščina • ‎suomi • ‎svenska • ‎български • ‎українська • ‎հայերեն • ‎فارسی • ‎ქართული • ‎中文 • ‎日本語

ՎիզուալԽմբագրիչի ծանոթագրության գործիքը թույլ է տալիս ՎիզուալԽմբարիչում հեշտությամբ ավելացնել, հանել և խմբագրել ծանոթագրությունները: To enable the tool, you'll need the following: a working installation of VisualEditor and Parsoid, citation templates on your wiki that use TemplateData to specify how they are invoked, and a special .json message in order to hook VisualEditor and the templates together.

Ծանոթագրության կաղապարների ներմուծում

Ձեզ անհրաժեշտ կլինեն ծանոթագրության կաղապարներ այս ամենից օգտվելու համար:

All Wikipedias and other WMF wikis already have all of these things installed.

  1. Կաղապար:Cite_web, Կաղապար:Cite_news, Կաղապար:Cite_journal, Կաղապար:Cite_book և այլ կաղապարների ներառում: Recent versions of these templates at the English Wikipedia and some others also require the supporting Lua modules.
  2. Ներբեռնել ձեր կաղապարները` օգտագործելով Special:Import էջը (օրինակ` http://localhost/index.php/Special:Import)

Կաղապարի տվյալներ

ՎիզուալԽմբագրիչում կաղապարի տվյալը բացելու համար ձեզ պետք կգա ԿաղապարիՏվյալ հավելվածը:

Ծանոթագրության գործիքի նշանակություն

ՎիզուալԽմբագրիչի ծանոթագրության գործիքն ակտիվացնելու համար անհրաժեշտ է ձեր վիքիում ստեղծել հատուկ հաղորդագրություն` MediaWiki:Visualeditor-cite-tool-definition.json:

Կարգավորման հաղորդագրության նպատակը

Հաղորդագրություն.

  • Ցույց է տալիս, թե ձեր վիքիի որ կաղապարներն են օգտագործում ստանդարտ ծանոթագրություններ:
    • Ուշադրություն. յուրաքանչյուր կաղապար պետք է ունենա ԿաղապարիՏվյալ Եթե ձեր վիքիում բացակայում են ծանոթագրության կաղապարները, ապա կարող եք դրանք սարքել` օգտվելով այլ վիքիներից:
  • Ցույց է տալիս, թե որ պիտակն եք ցանկանում օգտագործել յուրաքանչյուր տեսակի ծանոթագրության համար:
    • Նրանք չորսն են` "կայք", "գիրք", "նորություններ" և "ամսագիր", որոնք համապատասխանում են MediaWiki:Visualeditor-cite-tool-name-web և այլն:
  • Ցույց է տալիս, թե որ պատկերն եք ցանկանում օգտագործել յուրաքանչյուր տեսակի ծանոթագրության համար:
    • Նրանք չորսն են` "ref-cite-web", "ref-cite-book", "ref-cite-news" և "ref-cite-journal", որոնք համապատասխանում են CSS դասին:

Երբ ստեղծվի MediaWiki:Visualeditor-cite-tool-definition.json կարգավորման հրամանը, ծանոթագրության գործիքը հասանելի կլինի ՎիզուալԽմբագրիչում:

Լրացուցիչ տեսակներ

Եթե ցանկանում եք նոր տեսակ ավելացնել, ծրագրավորողների խումբը մեծ հաճույքով կխոսի ձեր հետ և կօգնի ստեղծել համապատասխան պատկերը:

Նոր տեսակի ավելացման համար անհրաժեշտ է

  1. Որոշեք, թե ինչ տեսակ եք ցանկանում ստեղծել
    • Այս օրինակում ասվում է, որ եթե դուք ցանկանում եք ունենալ ծանոթագրության տվյալների շտեմարան, դուք կարող եք այն կոչել "տվյալների շտեմարան":
  2. Ստեղծել պիտակ դրա համար
    • Տվյալ օրինակի համար կարող եք սահմանել "db" անվանումը և ավելացնել պիտակը "database" արժեքով MediaWiki:Visualeditor-cite-tool-name-db մեջ:
  3. Ստեղծել պատկեր դրա համար
    • Տվյալ օրինակի համար կարող եք սահմանել "ref-cite-dbase" նկարը և ստեղծել SVG պատկեր և ներբեռնել այն Վիքիպահեստ: Այնուհետև ստեղծել "oo-ui-icon-ref-cite-dbase" պատկերի դասը և ավելացնել նախընտրած պատկերը "background-image:url(//upload.wikimedia.org/wikipedia/commons/1/12/VisualEditor_-_Icon_-_Ref_db.svg)" հետ:

Օրինակներ

Կարող եք օրինակներ տեսնել անգլերեն և լեհերեն վիքիներում: Copy the code to your wiki and adapt the names to the local context.

"Citation needed" tool

The "citation needed" tool.

"Citation needed" templates can be configured to show an "Add a citation" button in the editor by configuring MediaWiki:Visualeditor-template-tools-definition.json with a citationNeeded key.

The configuration value lists templates (which can contain multiple titles for redirects) and parameter mappings. Currently supported keys are:

  • reason - shows the reason a citation is needed in the context item
  • date - shows the date "citation needed" template was added in the context item
  • encapsulate - text which has been wrapped by the template, and which should be unwrapped when a citation is added

The value of these mappings is the name of the parameter(s) in the local template:

{
	"citationNeeded": [
		// This key is always "citationNeeded" in every language
		// Each item of this list represents a single template
		{
			"title": [
				// Title can be a string, or list of redirects
				"Citation needed",
				"Cn",
				...
			],
			"params": {
				"reason": "reason",
				"date": "date"
			}
		},
		// This template is defined separately as it supports the
		// "encapsulate" param. On some wikis this is the same
		// template as the one above.
		{
			"title": [
				"Citation needed span",
				"Cite needed span",
				...
			],
			"params": {
				// Parameters can be a string or list of aliases
				"encapsulate": [ "1", "text" ],
				"reason": "reason",
				"date": "date"
			}
		}
	]
}

See the example definition on English Wikipedia.

Խնդիրների հայտնաբերում

Եթե ԿաղապարիՏվյալը ներդրված է, սակայն ծանոթագրության պատուհանում դաշտերը չեն ցուցադրվում, ապա պետք է բացեք ծանոթագրության կաղապարը, փոփոխություններ չանեք և կրկին հիշել տաք այն: Սա ԿաղապարիՏվյալի միացման հետ կապված խնդիր է:

Հաշվի առեք, որ մասնակիցները ավելի դժվարությամբ կկիրառեն ձեր ծանոթագրության կաղապարները, քան այն տարածված չորսը: