Help: Difference between revisions

From Clavis Canonum
m (typo)
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
Welcome to the Help page of the Clavis Wiki. It provides practical help on common issues and basic problems on various issues - feel free to edit it yourself.
== Tutorials ==
There also are some tutorials; as of 2023, we have published only two of them: https://www.youtube.com/watch?v=wDSPUM2cKyM (5 min) and https://www.youtube.com/watch?v=NAiR6htX-j8 (15 min).
== Discussions ==
Every page has a discussion page ("Discussion" beingt highlighted blue, or in red when the page is still empty). Click on "+ new topic" in the upper right corner to start a discussion, or "[ reply ]" below existing posts to reply to others. Please do not use "edit source" on discussion pages.
== Create a Page ==
=== How to create a page ===
To create a new page, the easiest way is first to create a link: choose <code><nowiki>Edit</nowiki></code>, highlight the word(s) you want to contain the link, then click on the "link" icon (next to the "bullet list" icon), and enter the name of the new page (see below for naming conventions). Save the change, and you should see that the word(s) in question are either blue (if the page already exists) or red (if not).
If it exists, go to the page and start improving; if not, simply click on the red link, and you will prompted to create the page. Simply start typing, do not forget to save your changes, and once you saved your entries for the first time, the page exists. You can go back to the page with the red link, refresh it, and the red link should now turn blue.
In order that the new page is found by other users, insert links to the new page in other articles (and vice versa), and if can, place it in at least one category (if you don‘t know how to do this, leave this to others).
=== Naming manuscripts ===
The page name for an article on a manuscript should consist of "place name, library name, shelfmark". For details, see [[Conventions on referencing manuscripts]].
=== Naming collections ===
The Clavis Wiki refers to canon law collections by their conventional names. However, at the same time we try to be consistent and to avoid giving the same name to two collections. "Consistency" means that we almost always use the Latin form where one exists, that we use Roman (not Arab) numbers for collections named after the books etc. they are divided into, and use Roman numbers to distinguish several collections found in the same manuscript. Where two or more collections have been given the same name in previous scholarship (all the [[Collectio Sangermanensis|Collectiones Sangermanenses]], the various [[Collectio IX librorum|collections in nine books]], and so on), the more established name is retained, and the other collection(s) are given new names, often referring to a manuscript they are found in.
If two or more collections can be confused, this should be mentioned in the respective articles. In some cases, a separate page explaining the different meanings of individual names are useful (e.g. [[Collectio Vaticana|''Collectio Vaticana'']]). Vice versa, if a collection is known under several names, this can and should be mentioned in the article and/or the infobox (see e.g. ''[[Collectio Dionysiana adaucta]]'').
Do not worry too much about the correct name if you start a new article. It can always be changed later.
== Insert links ==
== Insert links ==
Inserting links is easy:
Inserting links is both important and easy. In addition to the instruction right below, there also is a tutorial: https://www.youtube.com/watch?v=NAiR6htX-j8.
* External links are enclosed in single square brackets, with the optional link text separated from the URL by a "|" and a space (!). Link text can be formatted.
 
* If you simply type (or copy&paste) a URL, this will create a link, too.
=== Edit modus ===
* Internal links (to other pages of the Clavis Wiki) are enclosed in double (!) square brackets, with the optional link text separate with a "|" (no space). If no site exists, placing a term between double square brackets will create a page of that name.
The quickest way to insert a link is simply by turning on the edit mode. So go to the page you want to edit, choose "edit", highlight the word(s) you want to contain the link, then click on the "link" icon (next to the "bullet list" icon). A menue will open. There are two options:
* To insert an internal link (i.e. to another Clavis Wiki page), enter the page name, for example "Collectio Dionysiana I". A drop-down menue will suggest titles of existing pages as you type; simply select the respective title and confirm.
* To insert an external link (any pages outside the Clavis Wiki), enter the URL in the same menue, for example "https://www.mgh.de".
 
In any case, use "save changes" in upper right corner, and confirm when prompted. Links to existing pages appear in blue.
 
=== Edit source modus ===
If you insert many links and want to control all options, you may find the "edit source" modus convenient. When you choose the <code><nowiki>"Edit source"</nowiki></code> mode, you will see what the links look like; you can also correct the link texts directly at this occasion.
* Example: <code><nowiki>[[Collectio Dionysiana I]]</nowiki></code> results in: [[Collectio Dionysiana I]].
* Example: <code><nowiki>https://www.mgh.de/</nowiki></code> results in: https://www.mgh.de/.
=== External links ===
External links are all links to sites outside this wiki. Inserting them is easy:
* If you simply type (or copy&paste) a URL, this will create a link. Easy! See example no. 1 below.
* The URL has to start with "https://" - if not, there will be no link see example no. 2 below.
* If you place the URL between square brackets, the link will have a running number as its name (see example no. 3).
* If you want the link to have a link text (so the ugly URL is no immediately visible), simply insert it after the URL, with a space between URL and link text (no. 4).
* You can insert canon-specific links to the Clavis database. The easiest way is to copy&paste the URL from your browser. Note that "context" refers to how many entries before and after the canon are displayed. The key is part of the URL and also a good link name, so insert a space and the key at the end. See no. 5 below.  


Examples:
Examples:
* External link with link name <code><nowiki>[[www.mgh.de| MGH]]</nowiki></code> results in: [[www.mgh.de| MGH]]<br>
# <code><nowiki>https://www.mgh.de/de</nowiki></code> results in: https://www.mgh.de/de
* Internal link: <code><nowiki>[[The Dionysiana|The ''Dionysiana'']]</nowiki></code> results in: [[The Dionysiana|The ''Dionysiana'']]
# <code><nowiki>www.mgh.de</nowiki></code> results in: www.mgh.de
# <code><nowiki>[https://www.mgh.de/de]</nowiki></code> and <code><nowiki>[https://www.dmgh.de/]</nowiki></code>  results in: [https://www.mgh.de/de] and [https://www.dmgh.de/]
# <code><nowiki>[https://www.mgh.de/de MGH]</nowiki></code> results in: [https://www.mgh.de/de MGH]
# <code><nowiki>[https://beta.mgh.de/databases/clavis/db/search?context=3&key=DU01.090 DU01.090]</nowiki></code> results in: [https://beta.mgh.de/databases/clavis/db/search?context=3&key=DU01.090 DU01.090]
 
=== Internal links ===
Internal links are links within this Clavis Wiki, e.g. from the description to one collection to that of another one.
 
Internal links are enclosed in double (!) square brackets, with the optional link text separate with a "|" (no space needed). If no site exists, placing a term between double square brackets will create a red link. While there is no page of that name, any user can click on a red link to create a new page of rhat name.
 
Examples
# <code><nowiki>[[Cresconius, Concordia canonum]]</nowiki></code> results in: [[Cresconius, Concordia canonum]] (simple internal link).
# <code><nowiki>[[Cresconius, Concordia canonum|Cresconius]]</nowiki></code> results in: [[Cresconius, Concordia canonum|Cresconius]] (internal link with link name different from page name).
# <code><nowiki>[[Cresconius, Concordia canonum|Cresconius, ''Concordia canonum'']]</nowiki></code> results in: [[Cresconius, Concordia canonum|Cresconius, ''Concordia canonum'']] (internal link with formatting).
# <code><nowiki>[[Collectio ficta]]</nowiki></code> results in: [[Collectio ficta]] (red link).
 
=== Links to categories ===
* If you want to link to a category (not add the article in question to a category!), place a colon (":") before "Category". This will create a link, so e.g. <code><nowiki>[[:Category:Wishlist MSS Digitization]]</nowiki></code> becomes [[:Category:Wishlist MSS Digitization]]. If you only insert <code><nowiki>[[Category ... </nowiki></code> (withou the colon), the relevant page will be placed in the respective category, and a link will appear not in the article itself but on the side bar.
 
[[Category:Help page]]

Revision as of 19:43, 25 August 2024

Welcome to the Help page of the Clavis Wiki. It provides practical help on common issues and basic problems on various issues - feel free to edit it yourself.

Tutorials

There also are some tutorials; as of 2023, we have published only two of them: https://www.youtube.com/watch?v=wDSPUM2cKyM (5 min) and https://www.youtube.com/watch?v=NAiR6htX-j8 (15 min).

Discussions

Every page has a discussion page ("Discussion" beingt highlighted blue, or in red when the page is still empty). Click on "+ new topic" in the upper right corner to start a discussion, or "[ reply ]" below existing posts to reply to others. Please do not use "edit source" on discussion pages.

Create a Page

How to create a page

To create a new page, the easiest way is first to create a link: choose Edit, highlight the word(s) you want to contain the link, then click on the "link" icon (next to the "bullet list" icon), and enter the name of the new page (see below for naming conventions). Save the change, and you should see that the word(s) in question are either blue (if the page already exists) or red (if not).

If it exists, go to the page and start improving; if not, simply click on the red link, and you will prompted to create the page. Simply start typing, do not forget to save your changes, and once you saved your entries for the first time, the page exists. You can go back to the page with the red link, refresh it, and the red link should now turn blue.

In order that the new page is found by other users, insert links to the new page in other articles (and vice versa), and if can, place it in at least one category (if you don‘t know how to do this, leave this to others).

Naming manuscripts

The page name for an article on a manuscript should consist of "place name, library name, shelfmark". For details, see Conventions on referencing manuscripts.

Naming collections

The Clavis Wiki refers to canon law collections by their conventional names. However, at the same time we try to be consistent and to avoid giving the same name to two collections. "Consistency" means that we almost always use the Latin form where one exists, that we use Roman (not Arab) numbers for collections named after the books etc. they are divided into, and use Roman numbers to distinguish several collections found in the same manuscript. Where two or more collections have been given the same name in previous scholarship (all the Collectiones Sangermanenses, the various collections in nine books, and so on), the more established name is retained, and the other collection(s) are given new names, often referring to a manuscript they are found in.

If two or more collections can be confused, this should be mentioned in the respective articles. In some cases, a separate page explaining the different meanings of individual names are useful (e.g. Collectio Vaticana). Vice versa, if a collection is known under several names, this can and should be mentioned in the article and/or the infobox (see e.g. Collectio Dionysiana adaucta).

Do not worry too much about the correct name if you start a new article. It can always be changed later.

Insert links

Inserting links is both important and easy. In addition to the instruction right below, there also is a tutorial: https://www.youtube.com/watch?v=NAiR6htX-j8.

Edit modus

The quickest way to insert a link is simply by turning on the edit mode. So go to the page you want to edit, choose "edit", highlight the word(s) you want to contain the link, then click on the "link" icon (next to the "bullet list" icon). A menue will open. There are two options:

  • To insert an internal link (i.e. to another Clavis Wiki page), enter the page name, for example "Collectio Dionysiana I". A drop-down menue will suggest titles of existing pages as you type; simply select the respective title and confirm.
  • To insert an external link (any pages outside the Clavis Wiki), enter the URL in the same menue, for example "https://www.mgh.de".

In any case, use "save changes" in upper right corner, and confirm when prompted. Links to existing pages appear in blue.

Edit source modus

If you insert many links and want to control all options, you may find the "edit source" modus convenient. When you choose the "Edit source" mode, you will see what the links look like; you can also correct the link texts directly at this occasion.

External links

External links are all links to sites outside this wiki. Inserting them is easy:

  • If you simply type (or copy&paste) a URL, this will create a link. Easy! See example no. 1 below.
  • The URL has to start with "https://" - if not, there will be no link see example no. 2 below.
  • If you place the URL between square brackets, the link will have a running number as its name (see example no. 3).
  • If you want the link to have a link text (so the ugly URL is no immediately visible), simply insert it after the URL, with a space between URL and link text (no. 4).
  • You can insert canon-specific links to the Clavis database. The easiest way is to copy&paste the URL from your browser. Note that "context" refers to how many entries before and after the canon are displayed. The key is part of the URL and also a good link name, so insert a space and the key at the end. See no. 5 below.

Examples:

  1. https://www.mgh.de/de results in: https://www.mgh.de/de
  2. www.mgh.de results in: www.mgh.de
  3. [https://www.mgh.de/de] and [https://www.dmgh.de/] results in: [1] and [2]
  4. [https://www.mgh.de/de MGH] results in: MGH
  5. [https://beta.mgh.de/databases/clavis/db/search?context=3&key=DU01.090 DU01.090] results in: DU01.090

Internal links

Internal links are links within this Clavis Wiki, e.g. from the description to one collection to that of another one.

Internal links are enclosed in double (!) square brackets, with the optional link text separate with a "|" (no space needed). If no site exists, placing a term between double square brackets will create a red link. While there is no page of that name, any user can click on a red link to create a new page of rhat name.

Examples

  1. [[Cresconius, Concordia canonum]] results in: Cresconius, Concordia canonum (simple internal link).
  2. [[Cresconius, Concordia canonum|Cresconius]] results in: Cresconius (internal link with link name different from page name).
  3. [[Cresconius, Concordia canonum|Cresconius, ''Concordia canonum'']] results in: Cresconius, Concordia canonum (internal link with formatting).
  4. [[Collectio ficta]] results in: Collectio ficta (red link).

Links to categories

  • If you want to link to a category (not add the article in question to a category!), place a colon (":") before "Category". This will create a link, so e.g. [[:Category:Wishlist MSS Digitization]] becomes Category:Wishlist MSS Digitization. If you only insert [[Category ... (withou the colon), the relevant page will be placed in the respective category, and a link will appear not in the article itself but on the side bar.