FamilySearch Wiki:WikiProject Creating Interwiki Links: Difference between revisions

From FamilySearch Wiki
(Created page with "__NOTOC__ {{breadcrumb | link1=Current Projects page | link2= | link3= | link4= | link5=Fixing broken links }} === Purpose === This...")
 
(fixing old link)
 
(62 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
{{breadcrumb
{{breadcrumb
| link1=[[FamilySearch Wiki:Current Projects|Current Projects page]]
| link1=[[FamilySearch Wiki:Current Projects|Current Projects page]]
Line 5: Line 4:
| link3=
| link3=
| link4=
| link4=
| link5=Fixing broken links
| link5=Adding Interwiki Links
}}  
}}  


=== Purpose  ===
== Purpose  ==


This project will help you determine the correct links to replace broken links found on Wiki pages. This is especially helpful for English websites and may not cover those websites in other languages.
We have a new Wiki extension that allows us to move the link (located on the left side bar) indicating if that Wiki page is available in different languages. We will be editing the former Language template at the bottom of the page to create this new link. This will improve visibility and accessibility to Wiki articles in multiple languages.


=== Project Contact  ===
== <font color="red">Before you Begin</font> ==
''Each Wiki has it's own separate editing rights. You should have already received editing rights for the English Wiki.<br>
'''To request editing rights for all ten of the language wikis:''' <br>
1. Go to the [[Main Page|English Wiki Home Page]]<br>
2. Sign in <br>
3. Scroll to the bottom of the home page, until you see "In other languages"<br>
:[[File:Language wiki links.PNG|1000px]]<br>
4. Click on the link to each language wiki so that it recognizes your username. <br>
5. Email Heather (Heather.mecham@familysearch.org) and let her know you're ready for editing rights to the language wikis.<br>


[[User:Batsondl|Danielle]]
== Task List ==
'''Do this task list first:'''<br>
*English Wiki: [https://docs.google.com/spreadsheets/d/1RSgNveco0sX4h8W2MsmhiIZ3xWw2P4mDsQn9nVfHysI/edit?usp=sharing Task List]


=== Task Page ===
[https://docs.google.com/spreadsheets/d/19ubUDl6j9ppd_kidncDBU01Xh93O2U9yiJdFbZ0_Z7I/edit?usp=sharing Task List]


=== Project Instructions  ===
Note about the Language Google Sheets:<br>


==== Step 1  ====
*Spanish Wiki: [https://docs.google.com/spreadsheets/d/1T6iflF6nRhglrhuYVTdF3UOnLCJdmMBdiCUZxe-0eqM/edit?usp=sharing Task List]
*Portuguese Wiki: [https://docs.google.com/spreadsheets/d/1hKRm35DwsY_jKww73mIk2C5NOCoqBJ2PtJDAACwN89M/edit?usp=sharing Task List]
*German Wiki: [https://docs.google.com/spreadsheets/d/1J6wSSGsTek-QkhwrpVisojPTfB4G5JOWwyTsG3A5pTM/edit?usp=sharing Task List]
*French Wiki: [https://docs.google.com/spreadsheets/d/1dwOclVilp60dtA6wOjI7u302QtZ6hzUqlrLFkkSeS54/edit?usp=sharing Task List]
*Russian Wiki: [https://docs.google.com/spreadsheets/d/1kWkSu1MfBZF3knkEir1pDeLp3QwgaWF0aYwGHZS06jI/edit?usp=sharing Task List]
*Swedish Wiki: [https://docs.google.com/spreadsheets/d/1f7ea7YK2CMZvpVOBbDThEeJgvS8mwapi1_JlstveUDw/edit?usp=sharing Task List]
*Chinese, Japanese, and Italian: [https://docs.google.com/spreadsheets/d/1ly3Nah08RpAtS0iC68x9ENjhUWtQ3HJ5DEPX0S0xWBE/edit?usp=sharing Task List] (do each tab)


*Go to the [https://docs.google.com/spreadsheets/d/19ubUDl6j9ppd_kidncDBU01Xh93O2U9yiJdFbZ0_Z7I/edit?usp=sharing Task List] and '''choose a line in gray''' (NOT the orange) that has a broken link to work on. Those in orange will be completed by someone else in another project.  Put your name in column I so no one else will work on the link.
== Project Instructions ==


==== Step 2 ====
=== Step 1 - Sign up for a page to fix ===


*Copy the broken link found on the spreadsheet and check to see if the link is still broken. (Sometimes websites are down for short amount of time.)
1. From the list above, choose a task list to work on and click on the link. it will open a Google Sheet. We suggest starting with the English Wiki. You will not need to know the language to fix the language Wiki pages.<br><br>


==== Step 3  ====
2. On the Google Sheet, choose a Wiki page and put your name in column A. Once you have completed the task, you will return to the Google Sheet and put the date beside your name.<br> <br>
*Go to: [https://archive.org/web/ https://archive.org/web/]. This website has the Wayback Machine. The Wayback Machine has a history of what a URL used to contain. This will help you know what the page contained so you can Google and locate the page more easily.  
==== Step 4  ====


*In the Wayback machine URL field at the very top of the page, paste in your link. Then press the “Browse History” button<br>  
3. Click on the link to go to that Wiki page. On a google sheet, after you click on the link, a small dialogue box with the URL will appear. You must click the dialogue box link to open the Wiki page you will work on.<br><br>


[[File:Wayback.jpg|left|450x400px]]<br>  
[[File:Google sheet.PNG|700px]]<br><br>


<br> <br> <br> <br> <br> <br> <br> <br> <br>
=== Step 2 - Find the Language Link===


<br> <br> <br>
1. Once on the Wiki page, make sure you are logged into the Wiki. You will know if you are logged into the Wiki if you can see your FamilySearch username in the top right hand corner of the screen, as seen below with the username, Batsondl.<br><br>


==== Step 5  ====
[[File:Sign in boxes.PNG|600px]]<br><br>


*You will now see a calendar that lists when the webpage was archived. Choose a date that has a blue or yellow circle around it to see what the page looked like. It is suggested to try a day 2 or 3 years earlier. If the page shows up as a broken link, then try a date a year earlier until you see a web page.  
2. Once you are logged in, you will see a tab in the top right corner of the screen, labeled, "Edit Source." Click on that tab and you will now see the wikitext code for the page.<br><br>


<br>  
3. Use the scroll bar on the wikitext box and go to the bottom of the page. You will see some wikitext code that looks something like this:<br><br>


[[Image:Wayback1.png|left|450x400px|Wayback1.png]]<br>  
<nowiki>{{H-langs|en=United States Genealogy|es=Estados Unidos - Genealogía|pt=Estados Unidos}}</nowiki><br>


<br> <br> <br> <br> <br> <br> <br>  
This code creates two language Wiki links for the English Wiki page, United States Genealogy: one link to the Spanish Wiki (Estados Unidos - Genealogía) and one link to the Portuguese Wiki (pt=Estados Unidos).  That link looks like this when displayed at the bottom of the Wiki page:<br><br>


<br><br><br> <br><br><br>  
[[File:Language old link 2.PNG|450px]]<br><br>


==== Step 6  ====
=== Step 3 - Fix the Language Link(s) ===
Once you locate the code at the bottom of the page, you will now alter Spanish and Portuguese language links to match the coding for an Interwiki link by doing the following:<br><br>


*If the Wayback machine does NOT have an original version of the page, try CachedPages.com to see if it contains a copy. Go to: [http://www.cachedpages.com/ http://www.cachedpages.com/]<br>
'''Original wikitext code:'''<br>
<nowiki>{{H-langs|en=United States Genealogy|es=Estados Unidos - Genealogía|pt=Estados Unidos}}</nowiki><br><br>


Delete the http:// in the Enter URL field and paste the broken URL.  
1. Review the link to make sure the links are in the correct order. You are currently in the English Wiki and therefore, the link you will remove is for the English Wiki article. The "en" in the first part of the template indicates that the Wiki page listed is for the English Wiki. The articles for "es" and "pt" are the links you will convert to the new template and will link to the Spanish and Portuguese Wikis.<br><br>
2. To fix the Spanish link (indicated by the "es" in the template), delete the 2 curly brackets, template name and the en= and name of the English page. In this example we would take out the following wikitext: <nowiki>{{H-langs|en=United States Genealogy</nowiki><br><br>
The resulting wikitext code is:<br><br>
<nowiki>|es=Estados Unidos - Genealogía|pt=Estados Unidos}}</nowiki><br><br>
3. Remove the pipe or vertical bar ("<nowiki>|</nowiki>") and add 2 square brackets before the "es" which stands for the Spanish Wiki and it will now look like this:<br> <br>
<nowiki>[[es=Estados Unidos - Genealogía|pt=Estados Unidos}}</nowiki><br><br>
4. Change the equal sign to a colon and it will now look like this:<br><br>
<nowiki>[[es:Estados Unidos - Genealogía|pt=Estados Unidos}}</nowiki><br><br>
5. Now replace the pipe with two square brackets facing the left. It will now look like this:<br><br>
<nowiki>[[es:Estados Unidos - Genealogía]]pt=Estados Unidos}}</nowiki><br><br>
6. If there was only one language link, you would skip the next part to Step 4.<br><br>


<br>  
'''Change other Language Link, if necessary'''<br><br>
7. Because there are two links in this example (Spanish and Portuguese), you need to create the other language template. Do this by going to the end of the Spanish word and the square brackets, "Genealogía]]" and click on the "Enter" key to make the rest of the link go to the next line. The remaining wikitext should be:<br><br>
<nowiki>pt=Estados Unidos}}</nowiki><br><br>
8. Change the Portuguese link the same way you did the Spanish link by changing the equal sign to a colon, removing the curly brackets at the end of the link, and by adding square brackets to the beginning and the end of the link, like this:<br><br>
<nowiki>[[pt:Estados Unidos]]</nowiki><br><br>
9. The new completed wikitext code for the 2 language links should now look like this:<br><br>
<nowiki>[[es:Estados Unidos - Genealogía]]</nowiki><br><br>
<nowiki>[[pt:Estados Unidos]]</nowiki><br><br>


[[Image:Cachedpages.png|left|475x300px|Cachedpages.png]]<br>  
'''Note:''' Each language has an abbreviation that will send the user to the correct language Wiki age.<br>
Here is a key:<br>
*en: English<br>
*es: Spanish<br>
*pt: Portuguese<br>
*fr: French<br>
*de: German<br>
*it: Italian<br>
*ru: Russian<br>
*ja: Japanese<br>
*ko: Korean<br>
*zh: Chinese<br>
*sv: Swedish<br>


<br> <br> <br> <br> <br> <br> <br>
=== Step 4 - Review the Link  ===


<br>  
1. Now that the Interwiki templates for both Spanish and Portuguese are made, let's check to make sure it will appear on the page correctly.<br><br>
2. At the bottom of the page, you should see a "Show Preview" button. Click on it.<br><br>


==== Step 7  ====
[[File:Preview button.PNG|400px]]<br><br>


*Once you find the old webpage, review the old page and determine key words to use for when you use Google to locate the new URL.
3. Scroll up the page until you see below the Tools menu on the left side of the screen, the phrase, "In other languages"<br><br>
* Go to Google and search for the new URL.
**Try taking the beginning portion of the URL to locate a possible page.
**Try googling the title of the page with quotation marks around it to narrow down your results
'''EXAMPLE'''
*For the broken link: <nowiki>http://www.cyberdriveillinois.com/departments/archives/marriage.html</nowiki> the Wayback Machine gave the original [https://web.archive.org/web/20070206022737/http://www.cyberdriveillinois.com/departments/archives/marriage.html web page]
*The title of the page is: Illinois Statewide Marriage Index, 1763–1900 and you can see it is on the Illinois State Archives
*Type in google: Illinois state archives "Illinois Statewide Marriage Index, 1763–1900"
*The first result on the list is: <nowiki>https://www.ilsos.gov/isavital/marriagesrch.jsp</nowiki> and you will see that it is the same page as found in the Wayback Machine.


==== Step 8  ====
4. Directly below it you should see links labeled, Español and Português. Below is an example of interwiki links correctly displayed:<br><br>


*With the correct new URL, go to the wiki page found on the Task List and replace the broken link with the new one you have found. Be sure to check the page once you have updated it to be sure the new link you added works.
[[File:Interwiki links box.PNG|200px]]<br><br>


==== Step 9  ====
5. If the links do not appear on the page, review the above instructions and make any necessary adjustments to the wikitext code.<br><br>


*Return to the spreadsheet and record the date in column J and the new URL you used on the Wiki page in column K.  You can use column L to add any notes. <br><br>  
=== Step 5 - Save the Page ===
1. With the old template now converted into the 2 new templates and it displaying correctly, you can now save the page.<br><br>


==== If you can't find a new URL ====
2. Scroll back down the page and type, "Added Interwiki link" in the "Summary" field and click the blue button, "Save Changes."<br><br>
*If you are unable to locate a new link for the broken URL, put the link and identifying information on this [https://docs.google.com/spreadsheets/d/1xXNsqK3KTH8vOEBH_x9pGmmqhmpLlFjDC-E-OEZ7LIs/edit?usp=sharing spreadsheet].  Leave the reference on the wiki page and we will double check it.'''
*In column J of the [https://docs.google.com/spreadsheets/d/1w0thmOaPwJiNqfiPZ_bCp5ar8IEmR8JO1qtRNH6F9fc/edit?usp=sharing Task List], type, no URL found.  


3. Return to the task list and put the date you fixed the link beside your name.<br><br>
4. You can now choose another Wiki page and repeat the above steps.<br><br>
<br>




[[Category:WikiProjects]]
[[Category:WikiProjects]]

Latest revision as of 15:25, 21 October 2021

Adding Interwiki Links

Purpose[edit | edit source]

We have a new Wiki extension that allows us to move the link (located on the left side bar) indicating if that Wiki page is available in different languages. We will be editing the former Language template at the bottom of the page to create this new link. This will improve visibility and accessibility to Wiki articles in multiple languages.

Before you Begin[edit | edit source]

Each Wiki has it's own separate editing rights. You should have already received editing rights for the English Wiki.
To request editing rights for all ten of the language wikis:
1. Go to the English Wiki Home Page
2. Sign in
3. Scroll to the bottom of the home page, until you see "In other languages"

Language wiki links.PNG

4. Click on the link to each language wiki so that it recognizes your username.
5. Email Heather (Heather.mecham@familysearch.org) and let her know you're ready for editing rights to the language wikis.

Task List[edit | edit source]

Do this task list first:


Note about the Language Google Sheets:

Project Instructions[edit | edit source]

Step 1 - Sign up for a page to fix[edit | edit source]

1. From the list above, choose a task list to work on and click on the link. it will open a Google Sheet. We suggest starting with the English Wiki. You will not need to know the language to fix the language Wiki pages.

2. On the Google Sheet, choose a Wiki page and put your name in column A. Once you have completed the task, you will return to the Google Sheet and put the date beside your name.

3. Click on the link to go to that Wiki page. On a google sheet, after you click on the link, a small dialogue box with the URL will appear. You must click the dialogue box link to open the Wiki page you will work on.

Google sheet.PNG

Step 2 - Find the Language Link[edit | edit source]

1. Once on the Wiki page, make sure you are logged into the Wiki. You will know if you are logged into the Wiki if you can see your FamilySearch username in the top right hand corner of the screen, as seen below with the username, Batsondl.

Sign in boxes.PNG

2. Once you are logged in, you will see a tab in the top right corner of the screen, labeled, "Edit Source." Click on that tab and you will now see the wikitext code for the page.

3. Use the scroll bar on the wikitext box and go to the bottom of the page. You will see some wikitext code that looks something like this:

{{H-langs|en=United States Genealogy|es=Estados Unidos - Genealogía|pt=Estados Unidos}}

This code creates two language Wiki links for the English Wiki page, United States Genealogy: one link to the Spanish Wiki (Estados Unidos - Genealogía) and one link to the Portuguese Wiki (pt=Estados Unidos). That link looks like this when displayed at the bottom of the Wiki page:

Language old link 2.PNG

Step 3 - Fix the Language Link(s)[edit | edit source]

Once you locate the code at the bottom of the page, you will now alter Spanish and Portuguese language links to match the coding for an Interwiki link by doing the following:

Original wikitext code:

{{H-langs|en=United States Genealogy|es=Estados Unidos - Genealogía|pt=Estados Unidos}}

1. Review the link to make sure the links are in the correct order. You are currently in the English Wiki and therefore, the link you will remove is for the English Wiki article. The "en" in the first part of the template indicates that the Wiki page listed is for the English Wiki. The articles for "es" and "pt" are the links you will convert to the new template and will link to the Spanish and Portuguese Wikis.

2. To fix the Spanish link (indicated by the "es" in the template), delete the 2 curly brackets, template name and the en= and name of the English page. In this example we would take out the following wikitext: {{H-langs|en=United States Genealogy

The resulting wikitext code is:

|es=Estados Unidos - Genealogía|pt=Estados Unidos}}

3. Remove the pipe or vertical bar ("|") and add 2 square brackets before the "es" which stands for the Spanish Wiki and it will now look like this:

[[es=Estados Unidos - Genealogía|pt=Estados Unidos}}

4. Change the equal sign to a colon and it will now look like this:

[[es:Estados Unidos - Genealogía|pt=Estados Unidos}}

5. Now replace the pipe with two square brackets facing the left. It will now look like this:

[[es:Estados Unidos - Genealogía]]pt=Estados Unidos}}

6. If there was only one language link, you would skip the next part to Step 4.

Change other Language Link, if necessary

7. Because there are two links in this example (Spanish and Portuguese), you need to create the other language template. Do this by going to the end of the Spanish word and the square brackets, "Genealogía]]" and click on the "Enter" key to make the rest of the link go to the next line. The remaining wikitext should be:

pt=Estados Unidos}}

8. Change the Portuguese link the same way you did the Spanish link by changing the equal sign to a colon, removing the curly brackets at the end of the link, and by adding square brackets to the beginning and the end of the link, like this:

[[pt:Estados Unidos]]

9. The new completed wikitext code for the 2 language links should now look like this:

[[es:Estados Unidos - Genealogía]]

[[pt:Estados Unidos]]

Note: Each language has an abbreviation that will send the user to the correct language Wiki age.
Here is a key:

  • en: English
  • es: Spanish
  • pt: Portuguese
  • fr: French
  • de: German
  • it: Italian
  • ru: Russian
  • ja: Japanese
  • ko: Korean
  • zh: Chinese
  • sv: Swedish

Step 4 - Review the Link[edit | edit source]

1. Now that the Interwiki templates for both Spanish and Portuguese are made, let's check to make sure it will appear on the page correctly.

2. At the bottom of the page, you should see a "Show Preview" button. Click on it.

Preview button.PNG

3. Scroll up the page until you see below the Tools menu on the left side of the screen, the phrase, "In other languages"

4. Directly below it you should see links labeled, Español and Português. Below is an example of interwiki links correctly displayed:

Interwiki links box.PNG

5. If the links do not appear on the page, review the above instructions and make any necessary adjustments to the wikitext code.

Step 5 - Save the Page[edit | edit source]

1. With the old template now converted into the 2 new templates and it displaying correctly, you can now save the page.

2. Scroll back down the page and type, "Added Interwiki link" in the "Summary" field and click the blue button, "Save Changes."

3. Return to the task list and put the date you fixed the link beside your name.

4. You can now choose another Wiki page and repeat the above steps.