Resources/Wiki contribution - Revision history

Crogers: /* Page names vs page titles */

2018-11-07T00:26:05Z

‎Page names vs page titles

2018-09-16T03:13:51Z

‎Breadcrumbs

2018-08-06T20:46:25Z

‎Breadcrumbs: typo fix

2017-07-11T22:16:49Z

‎Admonitions: fix typo

2017-03-19T22:59:29Z

Fix manual breadcrumb

2017-03-19T22:58:47Z

Change breadscrumb to page, add WIP note

2017-03-19T22:56:41Z

Dan moved page Unification to Resources/Wiki contribution: Move out of temp location to main wiki

2016-07-12T16:59:50Z

‎Page names vs page titles: fix typo

2015-09-03T23:49:37Z

‎Admonitions

2015-08-13T00:20:55Z

‎Admonitions

@@ Line 62: / Line 62: @@
 * Page names are used to create and maintain the desired page hierarchy and permalink - e.g. <code>Development/Accession module/2.x development</code>
-* Page titles are used for display purposes - e.g. "Accession module - 2.x development"
+* Page titles (display titles) are used for display purposes - e.g. "Accession module - 2.x development"
 * Every page should be given a display title
 * Every new page name should begin with one of the 5 sections, and proceed accordingly so the page hierarchy is maintained

@@ Line 110: / Line 110: @@
 * Users should manually add breadcrumbs to new pages, leading back to the [[Main Page]]
 * These breadcrumbs should use the page name, NOT the display title
-* Doing so displays exposes the true page title to the user, which might be useful for search, and for understanding the wiki hierarchy
+* Doing so exposes the true page title to the user, which might be useful for search, and for understanding the wiki hierarchy
 * Adding the breadcrumb also seems to help with search results being returned
 * For long breadcrumbs, simplifying the final node to use only the unique part of the page name is acceptable

@@ Line 120: / Line 120: @@
 As discussed in the section above, we are using the true '''page name''' to create clean URLs that maintain the wiki organization and hierarchy, and then adding '''page display titles''' (using <code><nowiki>{{#pagetitle:Title goes here}}</nowiki></code> to add user-friendly page names for display.
-By obfuscating the actual page name however, we may be making it harder for users to find the desired content when searching, or when via recall upon a return visit.
+By obfuscating the actual page name however, we may be making it harder for users to find the desired content when searching, or when navigating via recall upon a return visit.
 The current version of  [https://www.mediawiki.org/wiki/MediaWiki Mediawiki] we are using does add simple breadcrumbs (links back to parent pages in a hierarchy, to assist users with orientation and navigation) automatically - but a) these use the display titles, not the page names, and b) they do not lead all the way back to the [[Main Page]] of the wiki.

@@ Line 205: / Line 205: @@
 <admonition type="seealso">
-This is a Seealso admonition. They are used to provide links to related wiki pages or external content. Often they are used in the introductary section of a wiki page (in case the user is not in fact on the page that would help them the most), but they can be used throughout as needed.
+This is a Seealso admonition. They are used to provide links to related wiki pages or external content. Often they are used in the introductory section of a wiki page (in case the user is not in fact on the page that would help them the most), but they can be used throughout as needed.
 </admonition>

@@ Line 1: / Line 1: @@
 {{#pagetitle:AtoM wiki style guide}}
-[[Main Page]] > '''Resources/Wiki_contribution'''
+[[Main Page]] > [[Resources]] > '''Resources/Wiki_contribution'''
 This page is a style guide for community users and Artefactual staff who intend to contribute content to the Access to Memory wiki. In 2015, we began a project of consolidation and reorganization, moving content from several different out-of-date wikis (Qubit-Toolkit, DCB, Artefactual Wiki, ICA-AtoM wiki), reorganizing it to make it more accessible, and updating it so it was still relevant to the project. We hope to keep this new wiki well organized with a consistent hierarchical structure to the pages, to make end user navigation much easier. The following guide will offer tips and suggestions on how to create pages for the wiki, in line with how other pages have been migrated thus far.

← Older revision	Revision as of 22:56, 19 March 2017
(No difference)

@@ Line 76: / Line 76: @@
 To nest this new page properly under the [[Community]] page, you will need to create a new page entitled <code>Community/Events</code>. You could name it <code>Community/Community_events</code>, but in terms of the permalink URL for the page, that would be redundant - the page is already in the Community section. This page name, used to maintain the hierarchy, is different from the display page title you can give the page after.
-Once you have created your page, you can now add a title, by adding a line of code at the top of the edit page, demonstrated below. So, if you want to name your page "Community events," and you don't wan it to display as "Community/Events" as you've created it, you can add the following:
+Once you have created your page, you can now add a title, by adding a line of code at the top of the edit page, demonstrated below. So, if you want to name your page "Community events," and you don't want it to display as "Community/Events" as you've created it, you can add the following:
 <pre>
@@ Line 103: / Line 103: @@
 Will display as: [[Community/Users|Users]]
 </admonition>
 ==Breadcrumbs==

← Older revision		Revision as of 23:49, 3 September 2015
Line 221:		Line 221:


−	Admonitions can be added to a page using the following syntax (this example will use the Note admonition.	+	Admonitions can be added to a page using the following syntax (this example will use the Note admonition):

	<pre>		<pre>

← Older revision		Revision as of 00:20, 13 August 2015
Line 191:		Line 191:

	-----		-----
		+
		+	'''Explanation'''

	As part of the basic styling of the AtoM wiki, there are 5 admonitions included that can be used when creating a page. These are similar to the admonitions used throughout the AtoM User and Administrator's manuals:		As part of the basic styling of the AtoM wiki, there are 5 admonitions included that can be used when creating a page. These are similar to the admonitions used throughout the AtoM User and Administrator's manuals: