Editor Tools: Difference between revisions

From SCA Heraldry Wiki
Jump to navigation Jump to search
(Created page with "=Migration Procedure= ===Phase 1:=== Make sure all pages on the calontiri wikispace have been successfully migrated to this new wiki. I'm just worrying about text content at...")
 
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Original sources should be linked and citations should be dated (working on adding dates)
=Migration Procedure=
=Migration Procedure=


===Phase 1:===
==Phase 2a: Categorization==
Make sure all pages on the calontiri wikispace have been successfully migrated to this new wiki.  I'm just worrying about text content at this point.  Broken images and Categories will be dealt with in Phase 2.
All pages need to be in categories in order to be backed-up efficiently with the Export Utility (see below)


*Open:
For now, Uncategorized pages will be categorized as "Need Work" in order to get them exportable as quickly as possible.
**http://calontiri.wikispaces.com/People and/or
**http://calontiri.wikispaces.com/Events on the calontiri wikispace
**(since People and Events are the bulk of the pages on the old wikispace).


*Cross-reference with:
==Phase 2b: Prettification==
**"[[Uncategorized Pages]]" and
**[[:Category:Pages with broken file links]]
**Since that's where the majority of the pages are conveniently listed
**Open the migrated page on the new wiki to make sure it isn't just a blank page.
 
*See below: Pages that didn't migrate successfully for for more details on how to move pages.
 
===Phase 2:===
Make sure the new pages are pretty.
Make sure the new pages are pretty.


*Check on:
*Check on:
**"[[Uncategorized Pages]]" and
**"[[Uncategorized Pages]]" and
**[[:Category:Pages with broken file links]]
**[[:Category:Pages with broken file links]] and
**Since where the pages with problems are conveniently listed
**[[:Category:Need Work]]
**Since where the pages with various problems are listed


*For reference, open on the old wiki:
*Fix formatting problems. Mostly commonly damaged:   
**http://calontiri.wikispaces.com/People and/or
**Bullet lists (* code), and
**http://calontiri.wikispaces.com/Events on the calontiri wikispace
**italics (' ' code)
**(since People and Events are the bulk of the pages on the old wikispace).
*Make sure images are okay (if not, see instructions above)
 
*Add categories to the bottom of the new page - Category:Names, Category:Armory, Category:English Names, etc.
*Fix formatting problems, mostly commonly damaged:   
**The full command is <nowiki>[[Category:Names]]</nowiki>, etc.
**Bullet lists (* code or use bullet icon on VisualEditor Bar), and
**Don't have to put in all possible categories to begin with, but the main category such as Names or Armory at least
**italics (' ' code or Ctrl-I or under <u>''A''</u> on VisualEditor Bar)
*Make sure images are okay (if not, see instructions below)
*Add categories to the bottom of the new page - Category:People, Category:Vatavian, Category:Scribe, etc.
**on VisualEditor, the Category tool is found under the stacked triple - icon on the right side between the ? icon and the pencil icon
*Save the changes.
*Save the changes.


Click on any new categories you just created and make sure their parent categories are correct.
Click on any new categories you just created and make sure their parent categories are correct.


= Creating New Accounts =
New users can be created by sysops ("bureaucrats"), in the following manner:


==Pages that didn't migrate sucessfully==
# Go to Special:Userlogin, when logged in as a sysop.
Find old unmoved page on calontiri wikispace
# Click on "Create an account" link to get to the account creation form.
 
# Enter the username and the new user's email address, and click the "by email" button.  
*Right-click on any images and save to a folder on your computer to be uploaded to the new wiki in Phase 2.
# The account will be created with a random password which is then emailed to the given address (as with the "forgot password" feature). The user will be requested to change password at first login; this is done, the e-mail address will be marked as confirmed.
 
#: <small>When you click the "create account" button instead, you have to manually send the user his password. If you've set $wgMinimalPasswordLength=0 (default configuration up to version 1.15) and you've left the password field blank, the user will be emailed an e-mail address confirmation request but will be unable to access Special:Confirmemail to perform the confirmation. Instead, the user will get an error (unless you've added it to $wgWhitelistRead); the user will be able to login with a blank password and then confirm email, but their password will not have been reset (it will have to be reset manually).</small>
*Open the old page for editing.
*Convert view to Wikitext Editor using the menu "down arrow" on the right side of the edit bar
*Copy the encoding.
 
Create the new page on calontiri.info
 
*Put the new page name in the search bar
*Click on the name in the search results where it prompts to '''Create the page "_____" on this wiki!'''
*Paste the encoding from the old page into the edit box.
*Correct the formatting problems as above.
*Deal with images as below.
 
*Add categories to the bottom of the new page - Category:People, Category:Vatavian, Category:Scribe, etc.
*Save the new page.
 
Upload the images you saved above:
 
*You have to be logged into your account to upload images
*Click on Insert -> Media on the VisualEditor Toolbar (or the "Upload File" button in the left toolbar in a separate tab)
*Follow the instructions on the Media edit window or Cut and Paste the image file name (Image.gif, etc. ) into the appropriate area (if not using the VisualEditor)
*Label images as appropriate
 
Click on any new categories you just created and make sure their parent categories are correct.
 
Go back to old wikispace page
 
*Change tag from "people" to "people moved", etc.
*Add note at top of old page, ''"This page has been moved to calontiri.info"''
*Lock the old page (under the ... button)


[[File:Blankpicture.png|right|Person Placeholder]]


[[File:BLANK TN.GIF|right|Blank Device Placeholder]]
[[File:BLANK TN.GIF|right|Blank Device Placeholder]]
 
[[File:BLANK BADGE.GIF|right|Blank Badge Placeholder]]
==Pages that migrated sucessfully==
Find new migrated page on calontiri.info
 
*Fix formatting problems.  Bullet lists (* or use icon on VisualEditor Bar), and italics (' ' or Ctrl-I) often don't convert properly.
*Make sure images are okay (if not, see instructions below)
*Add categories to the bottom of the new page - Category:People, Category:Vatavian, Category:Scribe, etc.
**on VisualEditor, the Category tool is found under the triple - icon on the right side between the ? icon and the pencil icon
**Don't have to put in all possible categories to begin with, but the main category such as People or Events at least
*Save the changes.
 
Click on any new categories you just created and make sure their parent categories are correct.
 
Go back to old wikispace page
 
*Change tag from "people" to "people moved" or from "event" to "event moved"
*Add note at top of old page, ''"This page has been moved to calontiri.info"''
*Lock the old page (under the ... button)


=Templates:=
=Templates:=
 
*Names - [[Template:Names]]
*People - [[Template:People]]
*Armory - [[Template:Armory]]
*Events - [[Template:Events]]
*References - [[Template:References]]
 
*Groups - [[Template:Groups]]
*Activities - [[Template:Activities]]
*Cultures - [[Template:Cultures]]
*Awards - [[Template:Awards]]
*Awards - [[Template:Awards]]
*Reigns - [[Template:Reigns&action=edit&redlink=1|Template:Reigns]]
*Kingdoms - [[Template:Kingdoms]]
 
*Name Consults - [[Template:Name Consults]]
To use a template:
*Armory Consults - [[Template:Armory Consults]]


*Open a new page like you normally would.  (Search for "Jane Doe" and click on  the name in the "Create the page "Jane Doe" on this wiki!" link.)
==To use a template:==
*In the edit box, put the code <nowiki>{{subst:People}}</nowiki>, or other Template name as appropriate.
Open a new page like you normally would.   
*(Search for "Jane Doe" and click on  the name in the "'''Create the page "Jane Doe" on this wiki!'''" link.)
In the edit box, put the code '''<nowiki>{{subst:Names}}</nowiki>, or other Template name''' as appropriate.
*Save the page without any other coding
*Save the page without any other coding
*This will substitute in the Template text.
*This will substitute in the Template text.
*Re-open the article for editing to personalize it and fill in the blanks.
Re-open the article for editing to fill in the blanks.
 
==Dynamic Template:==
There is a special type of ''dynamic'' template used for boilerplates that will automatically update across all the created pages with that command typed in, when the boilerplate is updated.  Aka "template call". Aka transclusion.
* Code to include on a page is:
**'''<nowiki>{{BoilerplateHeader}}</nowiki>'''
**'''<nowiki>{{BoilerplateFooter}}</nowiki>'''
* This code is on the above templates already, so only needs to be added if a Template isn't being used to create a new page.  Or if an old page is being updated to get rid of the old boilerplate.


=Categories/Subcategories:=
=Categories/Subcategories:=
Line 124: Line 72:
==Major categories are:==
==Major categories are:==


*People - citizens and friends of Calontir.  Subcategories for:  
*Names - information on documenting and submitting names in the SCA.  Subcategories for:  
**group membership (Vatavians or Coeur d'Ennui),
**Type (Personal Names, Given Names, Bynames, Branch Names, Order Names, Locative Bynames...)
**personas (Russians),
**Culture (English Names, French Names...),
**service (Waterbearers), etc.
**Theme/Meaning (flower names, water, battle...),
*Groups - branches, guilds, colleges, and households of Calontir.  Subcategories include:
**Lingual Mixes (?)
**Branches - official groups of the SCA, subcategories Vatavia, Coeur d'Ennui, etc.
**Others?
**Guilds - official guilds and colleges of Calontir, subcategories - Scribe's Guild, Brewer's Guild, etc.
*Armory - information related to arms, devices, badges.  Subcategories include:
**Households - unofficial, loosely defined groups of people based on a common interest, noble family, etc.
**Tinctures - colors, metals, furs and their combinations/contrasts
*Activities - martial, Art & Science, service
**Fields - field divisions, field treatments
*Events - official events in Calontir. Also should be cross-categorized:
**Charges - ordinaries, animate charges, inanimate charges (use categories as defined in the SCA Ordinary)
**Branch hosting (eg. Vatavia) and/or
**Culture (English Armory, French Armory, etc.),
**History (for major kingdom events like coronations)
*References - tools and standard SCA heraldry references.  Subcategories:
*Resources - kingdom information.  Subcategories:
**Consulting Tools - information on conflict checking, searches, etc. (Category:Consulting Tools)
**Awards
**Administrative Handbook
**History
**Standards for Evaluation of Names and Armory (SENA)
**Royal Lineage
**Heraldic Primers/Articles (Primers)
**Songs
**Rules Articles (Rules)
**Stories
**Kingdom - information about SCA Kingdoms: contacts, principal heralds, heraldry
**Awards - cross-reference under relevant Kingdom
**History - ?


Some subcategories fall under more than one category/subcategory.  For example, Vatavians is a subcategory of People, but also a subcategory of Vatavia.
A few subcategories may fall under more than one category/subcategory.  For example, Golden Calon Swan is a subcategory of Awards, but also a subcategory of Calontir.


MediaWiki automatically makes a Category page for any category assigned to a page.
MediaWiki automatically makes a Category page for any category assigned to a page.
    
    
Categories are assigned by putting the relevant code at the bottom of the page:   
Categories are assigned by putting the relevant code at the bottom of the page:   
*Using the text editor, <nowiki>[[Category:Name]]</nowiki>


*If using VisualEditor, the Category tool is found with the triple - icon on the right side between the ? icon and the pencil icon
Many pages will belong to multiple categories, and each category needs it's own bracketed command.
*If using the text editor, double-square brackets [[ around the Category:Name command, then closed-double-square brackets.
*For example, Golden Calon Swan is Category:Awards, Category:Calontir


Many pages will belong to multiple categories, and each category needs it's own bracketed command.
The same code is use to create category trees. 
*So the page Category:Awards would have the code for Category:References at the bottom.
 
=Backups=
==Exporting==
*Performing back-ups is done with the Export Utility.  This is linked in the menu as "Export Pages" or can be found near the bottom of "Special pages".
*Pages can either be added:
** en-bloc based on their Category (subcategories have to be loaded individually) OR
** one-by-one by title (which is obviously highly impractical)
*Export settings:
** Current revision, without history
** "Save as file"
** The template option doesn't seem to be necessary
*Save to the backup folder with descriptive name reflecting the main category being backed up for example, blah-blah-Armory-blah-blah.xml
*Images are already on the home computer in the folder they were uploaded out of.
 
==Importing==
*Find the Import page at the bottom of "Special Pages"
*Click on the previously exported xml files
*Done (?)
 
=Footer Image Code?=
 
 
$wgFooterIcons = [
"copyright" => [
"copyright" => [],
        // placeholder for the built in copyright icon
],
['poweredby']['myicon'] = [
"src" => "/logocaption.gif",
  // If you have a non-default sized icon you can specify the size yourself.
"height" => "31",
"width" => "88",
]
];


*For example, Sofya la Rus is Category:Hillians (Heraldshill), Category:Russians, Category:Heralds, etc.


The same code is use to create category trees.
[[File:Logocaption.jpg|right]]


*So the page Category:Vatavians would have the code for Category:Vatavia at the bottom (along with the code for Category:People).
[[Category:Wiki]]
*Then the Category:Vatavia, would have the code for its parent, Category:Branches.
*In turn, Category:Branches would have the code for its parent, Category:Groups .

Latest revision as of 11:23, 9 March 2024

Original sources should be linked and citations should be dated (working on adding dates)

Migration Procedure[edit | edit source]

Phase 2a: Categorization[edit | edit source]

All pages need to be in categories in order to be backed-up efficiently with the Export Utility (see below)

For now, Uncategorized pages will be categorized as "Need Work" in order to get them exportable as quickly as possible.

Phase 2b: Prettification[edit | edit source]

Make sure the new pages are pretty.

  • Fix formatting problems. Mostly commonly damaged:
    • Bullet lists (* code), and
    • italics (' ' code)
  • Make sure images are okay (if not, see instructions above)
  • Add categories to the bottom of the new page - Category:Names, Category:Armory, Category:English Names, etc.
    • The full command is [[Category:Names]], etc.
    • Don't have to put in all possible categories to begin with, but the main category such as Names or Armory at least
  • Save the changes.

Click on any new categories you just created and make sure their parent categories are correct.

Creating New Accounts[edit | edit source]

New users can be created by sysops ("bureaucrats"), in the following manner:

  1. Go to Special:Userlogin, when logged in as a sysop.
  2. Click on "Create an account" link to get to the account creation form.
  3. Enter the username and the new user's email address, and click the "by email" button.
  4. The account will be created with a random password which is then emailed to the given address (as with the "forgot password" feature). The user will be requested to change password at first login; this is done, the e-mail address will be marked as confirmed.
    When you click the "create account" button instead, you have to manually send the user his password. If you've set $wgMinimalPasswordLength=0 (default configuration up to version 1.15) and you've left the password field blank, the user will be emailed an e-mail address confirmation request but will be unable to access Special:Confirmemail to perform the confirmation. Instead, the user will get an error (unless you've added it to $wgWhitelistRead); the user will be able to login with a blank password and then confirm email, but their password will not have been reset (it will have to be reset manually).


Blank Device Placeholder
Blank Badge Placeholder

Templates:[edit | edit source]

To use a template:[edit | edit source]

Open a new page like you normally would.

  • (Search for "Jane Doe" and click on the name in the "Create the page "Jane Doe" on this wiki!" link.)

In the edit box, put the code {{subst:Names}}, or other Template name as appropriate.

  • Save the page without any other coding
  • This will substitute in the Template text.

Re-open the article for editing to fill in the blanks.

Dynamic Template:[edit | edit source]

There is a special type of dynamic template used for boilerplates that will automatically update across all the created pages with that command typed in, when the boilerplate is updated. Aka "template call". Aka transclusion.

  • Code to include on a page is:
    • {{BoilerplateHeader}}
    • {{BoilerplateFooter}}
  • This code is on the above templates already, so only needs to be added if a Template isn't being used to create a new page. Or if an old page is being updated to get rid of the old boilerplate.

Categories/Subcategories:[edit | edit source]

  • Categories and subcategories are used in MediaWiki to organize pages together much like tags were used on wikispaces.
  • Categories are case-sensitive.

Major categories are:[edit | edit source]

  • Names - information on documenting and submitting names in the SCA. Subcategories for:
    • Type (Personal Names, Given Names, Bynames, Branch Names, Order Names, Locative Bynames...)
    • Culture (English Names, French Names...),
    • Theme/Meaning (flower names, water, battle...),
    • Lingual Mixes (?)
    • Others?
  • Armory - information related to arms, devices, badges. Subcategories include:
    • Tinctures - colors, metals, furs and their combinations/contrasts
    • Fields - field divisions, field treatments
    • Charges - ordinaries, animate charges, inanimate charges (use categories as defined in the SCA Ordinary)
    • Culture (English Armory, French Armory, etc.),
  • References - tools and standard SCA heraldry references. Subcategories:
    • Consulting Tools - information on conflict checking, searches, etc. (Category:Consulting Tools)
    • Administrative Handbook
    • Standards for Evaluation of Names and Armory (SENA)
    • Heraldic Primers/Articles (Primers)
    • Rules Articles (Rules)
    • Kingdom - information about SCA Kingdoms: contacts, principal heralds, heraldry
    • Awards - cross-reference under relevant Kingdom
    • History - ?

A few subcategories may fall under more than one category/subcategory. For example, Golden Calon Swan is a subcategory of Awards, but also a subcategory of Calontir.

MediaWiki automatically makes a Category page for any category assigned to a page.

Categories are assigned by putting the relevant code at the bottom of the page:

  • Using the text editor, [[Category:Name]]

Many pages will belong to multiple categories, and each category needs it's own bracketed command.

  • For example, Golden Calon Swan is Category:Awards, Category:Calontir

The same code is use to create category trees.

  • So the page Category:Awards would have the code for Category:References at the bottom.

Backups[edit | edit source]

Exporting[edit | edit source]

  • Performing back-ups is done with the Export Utility. This is linked in the menu as "Export Pages" or can be found near the bottom of "Special pages".
  • Pages can either be added:
    • en-bloc based on their Category (subcategories have to be loaded individually) OR
    • one-by-one by title (which is obviously highly impractical)
  • Export settings:
    • Current revision, without history
    • "Save as file"
    • The template option doesn't seem to be necessary
  • Save to the backup folder with descriptive name reflecting the main category being backed up for example, blah-blah-Armory-blah-blah.xml
  • Images are already on the home computer in the folder they were uploaded out of.

Importing[edit | edit source]

  • Find the Import page at the bottom of "Special Pages"
  • Click on the previously exported xml files
  • Done (?)

Footer Image Code?[edit | edit source]

$wgFooterIcons = [ "copyright" => [ "copyright" => [],

       // placeholder for the built in copyright icon

], ['poweredby']['myicon'] = [ "src" => "/logocaption.gif",

  // If you have a non-default sized icon you can specify the size yourself.

"height" => "31", "width" => "88", ] ];


Logocaption.jpg