Guidelines for Creating an Example Page - Revision history

Aideng@uci.edu at 05:24, 18 January 2024

2024-01-18T05:24:48Z

← Older revision		Revision as of 05:24, 18 January 2024
Line 6:		Line 6:
	Example Pages can be accessed via a hyperlinked image and caption that can be included on the right side of any Topic Page as appropriate. One or more examples can also be linked to a single Topic Page by listing them under the “Examples” heading. Links may go directly to another website (e.g., DamFailures.org or YouTube.com). When the creation of Example Pages within the wiki is needed, these pages are formatted differently from the rest of the website. They typically feature an image carousel that can be used to share example photos and text in an interactive fashion.		Example Pages can be accessed via a hyperlinked image and caption that can be included on the right side of any Topic Page as appropriate. One or more examples can also be linked to a single Topic Page by listing them under the “Examples” heading. Links may go directly to another website (e.g., DamFailures.org or YouTube.com). When the creation of Example Pages within the wiki is needed, these pages are formatted differently from the rest of the website. They typically feature an image carousel that can be used to share example photos and text in an interactive fashion.

	A listing of all example pages created on the Dam Safety Toolbox can be ~~access~~ at [https://damtoolbox.org/wiki/Category:Example_Pages https://damtoolbox.org/wiki/Category:Example_Pages].		A listing of all example pages created on the Dam Safety Toolbox can be accessed at [https://damtoolbox.org/wiki/Category:Example_Pages https://damtoolbox.org/wiki/Category:Example_Pages].

			Watch the {{Video Icon}} [https://www.youtube.com/watch?v=9ROlM94OK1M Dam Safety Toolbox Tutorial: Creating an Example Page] for additional help.

	== Naming and Creating a New Example Page ==		== Naming and Creating a New Example Page ==

Grichards@gfnet.com at 15:35, 30 October 2023

2023-10-30T15:35:23Z

← Older revision		Revision as of 15:35, 30 October 2023
Line 8:		Line 8:
	A listing of all example pages created on the Dam Safety Toolbox can be access at [https://damtoolbox.org/wiki/Category:Example_Pages https://damtoolbox.org/wiki/Category:Example_Pages].		A listing of all example pages created on the Dam Safety Toolbox can be access at [https://damtoolbox.org/wiki/Category:Example_Pages https://damtoolbox.org/wiki/Category:Example_Pages].

	== Naming a New Example Page ==		== Naming and Creating a New Example Page ==
	Care should be taken when naming a new Example Page. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if creating an example page with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Failure Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in Example Page titles.		Care should be taken when naming a new Example Page. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if creating an example page with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Failure Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in Example Page titles.

			An easy way to create a new page within the wiki is use the "Search Toolbox" utility in the header of the site to search for the exact title of the page you wish to create. If the page or something similar already exists on the site, it will open or appear within the search results. In cases where similar content or page titles already exist, the existing page should be edited where possible to avoid duplication of content. If the page does not exist, an option to create this page will appear at the top of the search results. The title of the page should appear as red text indicating that an internal hyperlink has been created, but the linked page does not yet exist. By clicking on the red title link, the contributor is taken to the content editor for the new example page. The contributor then simply follows the instructions and template below to complete the creation of the new example page.

	== Typical Example Content ==		== Typical Example Content ==

Mpollei@gfnet.com at 17:06, 17 July 2023

2023-07-17T17:06:14Z

← Older revision		Revision as of 17:06, 17 July 2023
Line 23:		Line 23:
	----		----
	== New Example Page Template Code ==		== New Example Page Template Code ==
	The following template code can be copied and pasted into the editor when creating a new Example Page to facilitate the process of creating, formatting, and reviewing new content. ~~Users~~ should add or delete sections, pictures, and code as necessary for a specific example.		The following template code can be copied and pasted into the editor when creating a new Example Page to facilitate the process of creating, formatting, and reviewing new content. Contributors should add or delete sections, pictures, and code as necessary for a specific example.

	''<nowiki><!-- Default code to remove table of contents --></nowiki></br>		''<nowiki><!-- Default code to remove table of contents --></nowiki></br>

Grichards@gfnet.com at 18:05, 18 May 2023

2023-05-18T18:05:50Z

← Older revision		Revision as of 18:05, 18 May 2023
Line 9:		Line 9:

	== Naming a New Example Page ==		== Naming a New Example Page ==
	Care should be taken when naming a new Example Page. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if creating an example page with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in Example Page titles.		Care should be taken when naming a new Example Page. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if creating an example page with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Failure Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in Example Page titles.

	== Typical Example Content ==		== Typical Example Content ==

Rmanwaring at 23:22, 23 December 2022

2022-12-23T23:22:14Z

Grichards at 06:29, 23 December 2022

2022-12-23T06:29:54Z

← Older revision		Revision as of 06:29, 23 December 2022
Line 18:		Line 18:
	# '''Summary of content'''		# '''Summary of content'''
	# '''Content''' (gallery of images, link to video, etc.)		# '''Content''' (gallery of images, link to video, etc.)


	Formatting of an example page is more flexible than topic pages. The template code below can be used to create a basic example page that includes a key message along with a carousel of sample photos. Other images, hyperlinks, tables and figures can also be used to reinforce the message an example page is trying to convey.		Formatting of an example page is more flexible than topic pages. The template code below can be used to create a basic example page that includes a key message along with a carousel of sample photos. Other images, hyperlinks, tables and figures can also be used to reinforce the message an example page is trying to convey.

Grichards at 06:29, 23 December 2022

2022-12-23T06:29:26Z

← Older revision		Revision as of 06:29, 23 December 2022
Line 12:		Line 12:

	==Typical Example Content==		==Typical Example Content==
	At a minimum, an example will consist of ~~an external~~ link to a video, website, or other informative resource. An example page developed on the Dam Safety Toolbox site may include any and all of the following items:		At a minimum, an example will consist of a link to a video, website, or other informative resource. An example page developed on the Dam Safety Toolbox site may include any and all of the following items:

	# '''Title of example''' (this item is included in the title of the page)		# '''Title of example''' (this item is included in the title of the page)

Grichards at 06:28, 23 December 2022

2022-12-23T06:28:24Z

← Older revision		Revision as of 06:28, 23 December 2022
Line 9:		Line 9:

	==Naming a New Example Page==		==Naming a New Example Page==
	Care should be taken when naming a new example page. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if ~~[[Creating an Example Page\|~~creating an example page]] with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in example page titles.		Care should be taken when naming a new example page. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if creating an example page with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in example page titles.

	==Typical Example Content==		==Typical Example Content==

Grichards at 06:25, 23 December 2022

2022-12-23T06:25:13Z

← Older revision		Revision as of 06:25, 23 December 2022
Line 29:		Line 29:
	''<nowiki>[[Category:Undefined]] </nowiki></br>		''<nowiki>[[Category:Undefined]] </nowiki></br>
	''<nowiki></nowiki></br>		''<nowiki></nowiki></br>
	''<nowiki>''' ''Message:~~'' '''~~ <!-- Add key message of example page here --> </nowiki></br>		''<nowiki>''' ''Message: <!-- Add key message of example page here -->'' ''' </nowiki></br>
	''<nowiki></nowiki></br>		''<nowiki></nowiki></br>
	''<nowiki><gallery mode="slideshow" ></nowiki></br>		''<nowiki><gallery mode="slideshow" ></nowiki></br>

Grichards at 06:20, 23 December 2022

2022-12-23T06:20:03Z

← Older revision		Revision as of 06:20, 23 December 2022
Line 6:		Line 6:
	Example pages can be accessed via a hyperlinked image and caption that can be included on the right side of any topic page as appropriate. One or more examples can also be linked to a single topic page by listing them under the “Examples” heading. Links may go directly to another website (e.g., DamFailures.org or YouTube.com). When the creation of example pages within the wiki is needed, these pages are formatted differently from the rest of the website. They typically feature an image carousel that can be used to share example photos and text in an interactive fashion.		Example pages can be accessed via a hyperlinked image and caption that can be included on the right side of any topic page as appropriate. One or more examples can also be linked to a single topic page by listing them under the “Examples” heading. Links may go directly to another website (e.g., DamFailures.org or YouTube.com). When the creation of example pages within the wiki is needed, these pages are formatted differently from the rest of the website. They typically feature an image carousel that can be used to share example photos and text in an interactive fashion.

	A listing of all example pages created on the Dam Safety Toolbox can be access at [[Category:~~Example Pages]~~].		A listing of all example pages created on the Dam Safety Toolbox can be access at [https://damtoolbox.org/wiki/Category:Example_Pages https://damtoolbox.org/wiki/Category:Example_Pages].

	==Naming a New Example Page==		==Naming a New Example Page==
Line 19:		Line 19:
	# '''Content''' (gallery of images, link to video, etc.)		# '''Content''' (gallery of images, link to video, etc.)

			Formatting of an example page is more flexible than topic pages. The template code below can be used to create a basic example page that includes a key message along with a carousel of sample photos. Other images, hyperlinks, tables and figures can also be used to reinforce the message an example page is trying to convey.
	----		----
	== New Example Page Template Code ==		== New Example Page Template Code ==
	The following template code ~~should~~ be copied and pasted into the editor when creating a new example page to facilitate the process of creating, formatting, and reviewing new content. Users should add or delete sections, pictures, and code as necessary for a specific example.		The following template code can be copied and pasted into the editor when creating a new example page to facilitate the process of creating, formatting, and reviewing new content. Users should add or delete sections, pictures, and code as necessary for a specific example.

	~~<!-- Code for generic [[Topic Page Template]] -->~~

			''<nowiki><!-- Default code to remove table of contents --></nowiki></br>
			''<nowiki>__NOTOC__ </nowiki></br>
			''<nowiki><!-- Add Category to drive breadcrumb menus --> </nowiki></br>
			''<nowiki>[[Category:Undefined]] </nowiki></br>
			''<nowiki></nowiki></br>
			''<nowiki>''' ''Message:'' ''' <!-- Add key message of example page here --> </nowiki></br>
			''<nowiki></nowiki></br>
			''<nowiki><gallery mode="slideshow" ></nowiki></br>
			''<nowiki><!-- Add image files here --></nowiki></br>
			''<nowiki>File:HJ1.jpg\|Caption for Image 1.</nowiki></br>
			''<nowiki>File:HJ2.jpg\|Caption for Image 2.</nowiki></br>
			''<nowiki>File:HJ3.jpg\|Caption for Image 3.</nowiki></br>
			''<nowiki>File:HJ4.jpg\|Caption for Image 4.</nowiki></br>
			''<nowiki>File:HJ5.jpg\|Caption for Image 5.</nowiki></br>
			''<nowiki></gallery></nowiki></br>
			''<nowiki><!-- Citations will automatically populate if instructions on the "Guidelines for Inserting a Citation" are followed. --></nowiki></br>
			''<nowiki>{{Citations}} </nowiki></br>
			''<nowiki></nowiki></br>
			''<nowiki><!-- Revision history information and example page categorization --> </nowiki></br>
			''<nowiki>[[Category:Example Pages]] </nowiki></br>''
			''<nowiki>{{revhistinf}} </nowiki></br>''
	----		----

	<!-- Revision history information -->		<!-- Revision history information -->
	{{revhistinf}}		{{revhistinf}}

← Older revision		Revision as of 23:22, 23 December 2022
Line 2:		Line 2:
	[[Category: Dam Safety Toolbox Formatting/Style Guide]]		[[Category: Dam Safety Toolbox Formatting/Style Guide]]
	----		----
	The term ~~“example page”~~ has been adopted to refer to any reference on the site that is not a technical guidance document, training, or ~~best practices resource~~. These will typically consist of case studies or other real-life narratives that are illustrative of the technical topic being addressed. This type of content is important to incorporate in the Dam Safety Toolbox; many people learn more from examples or experiences than from technical reports, and these real-life examples help demonstrate the concepts described in such reports. Such pages may include links to case studies on ASDSO’s [https://damfailures.org/ DamFailures.org] website, links to YouTube or other online streaming platforms with pertinent videos, or “dead end” pages within the Technical Library itself that share case studies or other similar content.		The term “Example Page” has been adopted to refer to any reference on the site that is not a technical guidance document, training, or Best Practices Resource. These will typically consist of case studies or other real-life narratives that are illustrative of the technical topic being addressed. This type of content is important to incorporate in the Dam Safety Toolbox; many people learn more from examples or experiences than from technical reports, and these real-life examples help demonstrate the concepts described in such reports. Such pages may include links to case studies on ASDSO’s [https://damfailures.org/ DamFailures.org] website, links to YouTube or other online streaming platforms with pertinent videos, or “dead end” pages within the Technical Library itself that share case studies or other similar content.

	Example ~~pages~~ can be accessed via a hyperlinked image and caption that can be included on the right side of any ~~topic page~~ as appropriate. One or more examples can also be linked to a single ~~topic page~~ by listing them under the “Examples” heading. Links may go directly to another website (e.g., DamFailures.org or YouTube.com). When the creation of ~~example pages~~ within the wiki is needed, these pages are formatted differently from the rest of the website. They typically feature an image carousel that can be used to share example photos and text in an interactive fashion.		Example Pages can be accessed via a hyperlinked image and caption that can be included on the right side of any Topic Page as appropriate. One or more examples can also be linked to a single Topic Page by listing them under the “Examples” heading. Links may go directly to another website (e.g., DamFailures.org or YouTube.com). When the creation of Example Pages within the wiki is needed, these pages are formatted differently from the rest of the website. They typically feature an image carousel that can be used to share example photos and text in an interactive fashion.

	A listing of all example pages created on the Dam Safety Toolbox can be access at [https://damtoolbox.org/wiki/Category:Example_Pages https://damtoolbox.org/wiki/Category:Example_Pages].		A listing of all example pages created on the Dam Safety Toolbox can be access at [https://damtoolbox.org/wiki/Category:Example_Pages https://damtoolbox.org/wiki/Category:Example_Pages].

	==Naming a New Example Page==		== Naming a New Example Page ==
	Care should be taken when naming a new ~~example page~~. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if creating an example page with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in ~~example page~~ titles.		Care should be taken when naming a new Example Page. Avoid simplistic titles or terms that can mean multiple things or apply to more than one discipline. Rather, names of example pages should be as specific as possible. For example, if creating an example page with examples of spillway gate failure mechanisms, the page should be called "Examples of Spillway Gate Failures" or "Spillway Gate Mechanisms". If it was simply called "Gates" or "Gate Failure", these generic page titles may inadvertently auto-link to other pages on the website where a link is not appropriate. In general, the inclusion of terms like "examples", "samples", and "case studies" is encouraged in Example Page titles.

	==Typical Example Content==		== Typical Example Content ==
	At a minimum, an example will consist of a link to a video, website, or other informative resource. An ~~example page~~ developed on the Dam Safety Toolbox site may include any and all of the following items:		At a minimum, an example will consist of a link to a video, website, or other informative resource. An Example Page developed on the Dam Safety Toolbox site may include any and all of the following items:

	# '''Title of example''' (this item is included in the title of the page)		# '''Title of example''' (this item is included in the title of the page)
Line 20:		Line 20:


	Formatting of an ~~example page~~ is more flexible than ~~topic pages~~. The template code below can be used to create a basic ~~example page~~ that includes a key message along with a carousel of sample photos. Other images, hyperlinks, tables and figures can also be used to reinforce the message an example page is trying to convey.		Formatting of an Example Page is more flexible than Topic Pages. The template code below can be used to create a basic Example Page that includes a key message along with a carousel of sample photos. Other images, hyperlinks, tables and figures can also be used to reinforce the message an example page is trying to convey.
	----		----
	== New Example Page Template Code ==		== New Example Page Template Code ==
	The following template code can be copied and pasted into the editor when creating a new ~~example page~~ to facilitate the process of creating, formatting, and reviewing new content. Users should add or delete sections, pictures, and code as necessary for a specific example.		The following template code can be copied and pasted into the editor when creating a new Example Page to facilitate the process of creating, formatting, and reviewing new content. Users should add or delete sections, pictures, and code as necessary for a specific example.

	''<nowiki><!-- Default code to remove table of contents --></nowiki></br>		''<nowiki><!-- Default code to remove table of contents --></nowiki></br>