Author Topic: Linking transcriptions to Wiki articles  (Read 3328 times)

Janet Jaguar

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 10166
  • Smell the sea, feel the sky, & fly into the mystic
    • View Profile
Linking transcriptions to Wiki articles
« on: December 18, 2013, 02:40:51 am »
In summary, these are the templates explained below.
Once the instructions are worked through once, the templates by themselves will be pretty much self-explanatory.

Create an external links section

==External links==


Linking transcriptions to Wiki articles

* {{Cite web | title = Royal Navy Log Books - HMS Argonaut
| accessdate = 2014-01-15
| url = http;//www.naval-history.net/OWShips-WW1-05Argonaut.htm
|work=naval-history.net
}} OldWeather.org transcription of ship's logbooks August 1914 to September 1915



Including ship names linked to other Wiki articles

{{HMS|ship-name|disambiguation date/pennant|6}}
      - the 6 in the final field renders as "HMS ship-name"

{{HMS|ship-name|disambiguation date/pennant|2}}
       - the 2 in the final field renders as "ship-name" (ie without "HMS")

{{HMS|ship-name}}
       - you have no idea what the disambiguation date might be


Making Naval-History.net a reference for edited content  good only for British ships

* {{Old Weather | url = http;//www.naval-history.net/OWShips-WW1-02Inflexible.htm
 | vessel = HMS Inflexible
 | day = 7th and 8th | month = December | year= 1914
 }}
  The Inflexible's ship log and captain's after action report have been transcribed and are available at this link.


<ref>HMS Inflexible ship's log and after action report.</ref>




This is meant for a short cut for all editors who want to link their transcriptions to corresponding Wikipedia articles.  The coding and placement have been vetted by Wiki moderator Shem1805.  Thanks to hard work by our Kathy Wendolk, our material is considered "encyclopedic"; we can use our logs as references for article content, and the transcription pages can be attached as "external links" to any relevant article.  Both the jpeg links for individual log pages and the vessel page(s) on Naval-History.net are acceptable.  Any of our forum posts are not - all forums are too changeable and uncontrollable for their standards.

If you wish to write an article or edit current articles with our material, Wiki has tutorials and an article Wizard.  For sure you need to learn how to correctly reference any added content.  This was my formal welcome to Wiki.  It was more complete than I wanted to do, but it is very helpful.




Hello, and welcome to Wikipedia! Thank you for your contributions. I hope you like the place and decide to stay. Here are some pages that you might find helpful:
I hope you enjoy editing here and being a Wikipedian! Please sign your messages on discussion pages using four tildes (~~~~); this will automatically insert your username and the date. If you need help, check out Wikipedia:Questions, ask me on my talk page, or ask your question on this page and then place {{help me}} before the question. Again, welcome! Shem


The following posts are each intended to be narrow instructions for a single action.  In theory, if an editor wants to do only that, they will be able to copy/past the original templates at the start of the instructions and use them without having to learn the whole Wiki tutorials.
« Last Edit: January 07, 2014, 05:54:32 pm by Janet Jaguar »

Janet Jaguar

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 10166
  • Smell the sea, feel the sky, & fly into the mystic
    • View Profile
Re: Linking transcriptions to Wiki articles
« Reply #1 on: December 18, 2013, 03:06:49 am »
Preparing to Link transcriptions to Wiki articles

The point of this post is to create a copy/paste template for all links to Gordon's site with instructions, that anyone can use to inform Wiki articles of the logs they are editing.  When looking at the templates, everything in blue gets copy/pasted as is, unchanged.  Everything in red is specific to your ship and article and needs to be changed to match.


Basic Wiki Rules

  • ALL CAPS are not allowed, even when copy/pasting from original sources, and this includes ship names. 
  • Our transcriptions are definitely "External links". They are not internal to Wiki, and we are providing them after the articles were authored. 

First, because using all caps for emphasis or any other reason is not allowed, if you are getting your title by copy/paste from Gordon's headings in his Ship Histories, convert the all-caps ship names to normal first-letter-only Cap.  Also, do not capitalize other words that are not proper names.

Second, an "external links" section may not exist in your article, so then we have to create it.  (This is actually very easy.)  It is always the last section in the article, which has a built in danger that must be accommodated. 

Create an external links section
To create this section for our use when there isn't one, go right to the last section above the "Nav boxes" at the bottom of every page, usually Sources or References, and note carefully what the last words of the article are.  Open the [edit]. 

The danger here is, all of the admin nav boxes are at the bottom of that edit, and start with something that looks like this: {{Diadem class cruiser}}  Do not touch this stuff for any reason.  Find the last text that read as part of the article, and be sure there are at least three blank lines between it - and anything you add - and the nav box coding, so that will not be corrupted.

Type or copy/paste the line below:
==External links==
Be sure it is followed by several blank lines to create protective space for the nav boxes.

In the "Edit summary" under the edit box, say what you just did after the provided section title.  Example: /* References */ create external links

Click "Save page".

« Last Edit: December 18, 2013, 09:58:29 pm by Janet Jaguar »

Janet Jaguar

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 10166
  • Smell the sea, feel the sky, & fly into the mystic
    • View Profile
Re: Linking transcriptions to Wiki articles
« Reply #2 on: December 18, 2013, 03:55:29 am »
Linking transcriptions to Wiki articles

The point of this post is to create a copy/paste template for all links to Gordon's site with instructions, that anyone can use to inform Wiki articles of the logs they are editing.  When looking at the templates, everything in blue gets copy/pasted as is, unchanged.  Everything in red is specific to your ship and article and needs to be changed to match.


Example template: https://en.wikipedia.org/wiki/HMS_Argonaut_(1898)#External_links
Treat all 5 lines as a single unit to copy/paste after the red text has been personalized.



Quote
* {{Cite web | title = Royal Navy Log Books - HMS Argonaut
| accessdate = 2014-01-15
| url = http;//www.naval-history.net/OWShips-WW1-05Argonaut.htm
|work=naval-history.net
}} OldWeather.org transcription of ship's logbooks August 1914 to September 1915


Instructions
You will need to know what title you want to give your link, the url for the Naval-History.net page being linked, and what other information about it you many wish readers to know.  And of course, the Wiki article you are amending.

Go to the Wiki article and open the edit box for its "External links" section.  Be very careful to use (or make) space between the "==External links==" heading (and any previous links listed) and the admin nav box coding.

Copy/paste the 5-line template above into it, or if you prefer onto a scrap-paper document.

In this line, insert your chosen title for the link in place of the red text.
* {{Cite web | title = Royal Navy Log Books - HMS Argonaut

In this line, change this date to today's date.
| accessdate = 2014-01-15

In this line, replace this url with the url of the page you have chosen.
| url = http;//www.naval-history.net/OWShips-WW1-05Argonaut.htm

In these two lines, replace the red text with whatever you want to say about your link.  See below for aid in coding statements that contain ship names.  Or choose to delete the red text and say nothing.
|work=naval-history.net
}} OldWeather.org transcription of ship's logbooks August 1914 to September 1915


If you've been working from a doc, copy/paste it into the edit box now, carefully above the nav box coding.

In the "Edit summary" below the edit box, say what you just did after the provided section title.  Example: /* External links */ entered new link

Use preview to see how it looks if you wish.  Then click "Save page".

« Last Edit: January 07, 2014, 05:55:50 pm by Janet Jaguar »

Janet Jaguar

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 10166
  • Smell the sea, feel the sky, & fly into the mystic
    • View Profile
Re: Linking transcriptions to Wiki articles
« Reply #3 on: December 18, 2013, 06:15:47 am »
Including ship names linked to other Wiki articles

The point of this post is to create a copy/paste template for all internal Wiki links with instructions, that anyone can use to keep Wiki cross-referencing working.  When looking at the templates, everything in blue gets copy/pasted as is, unchanged.  Everything in red is specific to your ship and article and needs to be changed to match.  (See above posts for everything in green.)

This does not apply to the ship named within its own article.

Some of our ships do not have their own articles, but are including in articles about their class or type of ship.  Other articles are specifically about incidents like the Battle of Falkland Islands.  In these cases, it may feel simpler to link in Gordon's index page for our logs, and give them a list of names of ships in this class that we have logs for.  It is also necessary to use if you are editing content or creating articles.  Wiki moderator Shem was very clear that he wants this done every time we name a Royal Navy ship, at least in its first occurrence.  This does not include ever having to search out where these links are within Wiki, it is much simpler than that.
NOTE: Always prefix ships with HMS or RMS or RFA or SS when searching Wiki or you will go to the flower or town the ship is named for.


Example template:  https://en.wikipedia.org/wiki/Acacia-class_sloop#External_links



Quote
* {{Cite web
| title = Royal Navy Log Books of the World War 1 Era
| accessdate = 2013-12-15
| url = http;//www.naval-history.net/OWShips-LogBooksWW1.htm
|work=naval-history.net }}
  OldWeather.org transcription of ships' logbooks available for {{HMS|Acacia|1915|2}}, {{HMS|Bluebell|1915|2}}, {{HMS|Foxglove|1915|2}}, {{HMS|Hollyhock|1915|2}}, {{HMS|Laburnum|1915|2}}, {{HMS|Magnolia|1915|2}}, and {{HMS|Veronica|1915|2}}.


If you wish your link to go directly to the correct article, there are two templates to choose from.
  • {{HMS|ship-name|disambiguation date/pennant|6}}
     - the 6 in the final field renders as "HMS ship-name"
  • {{HMS|ship-name|disambiguation date/pennant|2}}
     - the 2 in the final field renders as "ship-name" (ie without "HMS")
For this post, I will be using only the "2" version to simplify life.


Instructions

In this field, change the prefix to HMT or RFA if the ship was never commissioned as HMS.  For merchant cruisers, you may want to try RMS or SS.
{{HMS|name of ship|disambiguation date/pennant|2}}

In this field, enter your ship's name.
{{HMS|ship-name|disambiguation date/pennant|2}}

In this field there are some choices. 
{{HMS|ship-name|disambiguation date/pennant|2}}

If you want the link to go directly to the ship's article without making readers go through the disambiguation page, do this.
  • If you are amending an article that already mentions your ship and that name is a blue link, roll your cursor over the ship name and you will see what year or pennant number distinguishes the article in parentheses after the name.  Put that in this field (without parentheses.)
  • If you are amending an article that already mentions your ship and that name is a red link, find the ship's launch date from Gordon's history page (not commission date for merchant cruisers) and put it in here.  If and when an article is written, your link to it will not have to be changed.
  • If you are in an article that describes the class but does not list ship names (such as for the river gunboats), put the launch date from Gordon's page in this field or drop down to the next choice.

If you do not know the launch date or Wiki disambiguation, or don't mind sending readers to a disambiguation page to pick the correct ship and article, simply remove all fields after the ship-name.
{{HMS|ship-name}}

Follow all instructions for completing editing.


At this point, if you believe there is an article in Wiki for your ship, it is very important to check that the link works - especially for our merchant cruisers, HMT trawlers and RFA oilers and water ships.  If their articles use a different prefix, they might not connect.  Even in using the Wiki search function, using HMS when they are listed as HMT or RFA may cause the search to fail.  The trawlers, for instance, are completely lost and neglected in Wiki unless they are among the very few purpose built for the RN.  Their war service gets no mention for all intents and purposes.

« Last Edit: December 22, 2013, 04:36:35 pm by Janet Jaguar »

Janet Jaguar

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 10166
  • Smell the sea, feel the sky, & fly into the mystic
    • View Profile
Re: Linking transcriptions to Wiki ship articles
« Reply #4 on: December 18, 2013, 07:52:28 pm »
Making Naval-History.net a reference for edited content

The point of this post is to create a copy/paste template for all links to Gordon's site with instructions, that anyone can use to inform Wiki articles of the logs they are editing.  When looking at the templates, everything in blue gets copy/pasted as is, unchanged.  Everything in red is specific to your ship and article and needs to be changed to match.


Example templates:  good only for British ships
I am using the HMS Inflexible as the example for this section.  My addition is the last reference in the Battle of the Falkland Islands section.  We have been given a Wiki template for using individual log pages from Gordon's site as references for changes or additions to various articles, found at  https://en.wikipedia.org/wiki/Template:Old_Weather

Use this template as is to cite Old Weather transcriptions in the reference section of articles. You must still use <ref> tags if you would like to use it in inline citations.

Example template:
     

* {{Old Weather | url = http;//www.naval-history.net/OWShips-WW1-02Inflexible.htm
 | vessel = HMS Inflexible
 | day = 7th and 8th | month = December | year= 1914
 }}
  The Inflexible's ship log and captain's after action report have been transcribed and are available at this link.

In this form, it is placed in the Reference section below the {{Reflist|2}}, or if the Bibliography section if it has one.  Portions of the text that use that reference are given reference number links using this template:
     
<ref>HMS Inflexible ship's log and after action report.</ref>

Instructions - entry in References or Bibliography
This works well in References, but if there is a Bibliography section that may be nice.  You will need to know the name and HMS-like prefix of your vessel, the url for the Naval-History.net page being linked, and the date(s) with the information being referenced.  And of course, the Wiki article you are amending.

Go to the Wiki article and open the edit box for its "References" or "Bibliography" section.  If the nav box coding is in this section, be very careful to use (or make) the space between the last reference used (might be only "{{reflist}}") and the admin nav box coding.

Copy/paste the 4-line template above into it, or if you prefer onto a scrap-paper document.

In this line, insert your Naval-History.net page url in place of the red text.
* {{Old Weather | url = http;//www.naval-history.net/OWShips-WW1-02Inflexible.htm

In this line, insert your vessel's name, including the HMS or whatever, in place of the red text.
| vessel = HMS Inflexible

In this line, insert the date of your information in day(s), month(s) and year(s) in place of the red text.
| day = 7th and 8th | month = December | year= 1914


In this line, replace the red text with whatever you want to say about your link.  See above for aid in coding statements that contain ship names.  Or choose to delete the red text and say nothing.
}}  The Inflexible's ship log and captain's after action report have been transcribed and are available at this link.

If you've been working from a doc, copy/paste it into the edit box now, carefully above the nav box coding.

In the "Edit summary" below the edit box, explain what you just did after the provided section title.  Example: /* References */ entered new reference

Use preview to see how it looks if you wish.  Then click "Save page".


Instructions - footnote reference number in the article text

This is a one line template, and there are two ways to do this.

(Method A)  In this line, replace the red text with your short ID of this ship's log reference as made above. 
<ref>HMS Inflexible ship's log and after action report.</ref>

Open the "[edit]" for the paragraph you wish to modify or just reference.  Place your cursor for the reference mark immediately after a word or sentence you wish to connect to the log, with no space. 

Copy/paste the template.

(Method B)  Open the "[edit]" for the paragraph you wish to modify or just reference.  In the toolbar above the edit box, click the "reference icon". 


Type in your short ID of this ship's log reference as made above into the entry box provided, and click "insert".

For both methods, in the "Edit summary" below the edit box, say what you just did after the provided section title.  Example: /* References */ entered new reference

Use preview to see how it looks if you wish.  Then click "Save page".

Rolling over the footnote number (automatically assigned by Wiki) creates a popup with the text you entered.

« Last Edit: January 07, 2014, 06:13:53 pm by Janet Jaguar »

Janet Jaguar

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 10166
  • Smell the sea, feel the sky, & fly into the mystic
    • View Profile
Re: Linking transcriptions to Wiki articles
« Reply #5 on: January 04, 2014, 07:58:09 am »
I have finished all the planned sections now, including how to reference our transcriptions to any amendments, etc, within Wiki articles.  All the templates are available, without instruction at the top of the initial post.

This topic is open for discussion.  Please add topic-relevant comments and information.