Read Me First - Revision history

AllenHuffman: /* Navigation Templates */

2016-09-01T17:28:25Z

Navigation Templates

← Older revision		Revision as of 13:28, 1 September 2016
Line 24:		Line 24:

	There are currently Navigation Templates for most major areas of the site:		There are currently Navigation Templates for most major areas of the site:
			* Template:NavArticles
			* Template:NavCompanies
			* Template:NavConventions
			* Template:NavHardware
			* Template:NavPeople
			* Template:NavSoftware
			...and many for sub-sections:
	* Template:NavCoCoNextGen		* Template:NavCoCoNextGen
	* Template:NavCoCoRelatives		* Template:NavCoCoRelatives
	* Template:NavCompanies
	* Template:NavComputerDoc		* Template:NavComputerDoc
	* Template:NavConventions
	* Template:NavDriveWire		* Template:NavDriveWire
	* Template:NavEmulators		* Template:NavEmulators
	* Template:NavFAQs		* Template:NavFAQs
	* Template:NavHardware
	* Template:NavHelp		* Template:NavHelp
	* Template:NavHome		* Template:NavHome
	* Template:NavInternetResources		* Template:NavInternetResources
	* Template:NavPeople
	* Template:NavProgramming		* Template:NavProgramming
	* Template:NavPublications		* Template:NavPublications
	* Template:NavScams		* Template:NavScams
	* Template:NavSoftware
	* Template:NavSoftwareGame		* Template:NavSoftwareGame
	* Template:NavSpecialProjects		* Template:NavSpecialProjects

AllenHuffman: /* Navigation Templates */

2016-09-01T17:26:09Z

Navigation Templates

← Older revision		Revision as of 13:26, 1 September 2016
Line 24:		Line 24:

	There are currently Navigation Templates for most major areas of the site:		There are currently Navigation Templates for most major areas of the site:
	* ~~NavArticles~~		* Template:NavCoCoNextGen
	* NavConventions		* Template:NavCoCoRelatives
	* ~~NavCompanies~~		* Template:NavCompanies
	* NavHardware		* Template:NavComputerDoc
	* NavInternetResources		* Template:NavConventions
	* NavPeople		* Template:NavDriveWire
	* NavPublications		* Template:NavEmulators
	* NavSoftware		* Template:NavFAQs
			* Template:NavHardware
			* Template:NavHelp
			* Template:NavHome
			* Template:NavInternetResources
			* Template:NavPeople
			* Template:NavProgramming
			* Template:NavPublications
			* Template:NavScams
			* Template:NavSoftware
			* Template:NavSoftwareGame
			* Template:NavSpecialProjects
			* Template:NavTimeline
			* Template:NavTop
			* Template:NavUsers
			* Template:NavVaporware

	If you truly are creating a new section big enough that it needs its own navigation link, here is how they currently work:		If you truly are creating a new section big enough that it needs its own navigation link, here is how they currently work:

AllenHuffman at 15:32, 1 September 2016

2016-09-01T15:32:05Z

← Older revision		Revision as of 11:32, 1 September 2016
Line 1:		Line 1:
	{{NavHelp}}		{{NavHelp}}
	~~= Read Me First =~~
	Here are a few quick things to know about using this wiki.		Here are a few quick things to know about using this wiki.

			== Page Layouts ==
			The ultimate goal is for each page to have a similar look-and-feel. When a new page is created, there is a bit of text you should paste in to the new page. These can be found on the [[Page Templates]] page.

			To explain what all those items do, read on...

	== Templates ==		== Templates ==
	This MediWiki ~~software~~ supports Templates. A template is a page with the name "Template:TemplateName". Anything on that template page will appear anywhere you include it on another page as "<nowiki>{{TemplateName}}</nowiki>". For example, if there was a page called "Template:UltimateAnswer", and that page contained the text "42", you could include that text on any page just by adding:		This website uses MediaWiki, which is the same software that runs the Wikipedia.

			MediWiki supports Templates. A template is a page with the name "Template:TemplateName". Anything on that template page will appear anywhere you include it on another page as "<nowiki>{{TemplateName}}</nowiki>". For example, if there was a page called "Template:UltimateAnswer", and that page contained the text "42", you could include that text on any page just by adding:

	<nowiki>{{UltimateAnswer}}</nowiki>		<nowiki>{{UltimateAnswer}}</nowiki>

			You should not need to make your own templates, but it is useful to know how they work since this site uses them extensively.

	=== Navigation Templates ===		=== Navigation Templates ===
Line 14:		Line 22:
	{{NavArticles}}		{{NavArticles}}
	</nowiki></pre>		</nowiki></pre>

			There are currently Navigation Templates for most major areas of the site:
			* NavArticles
			* NavConventions
			* NavCompanies
			* NavHardware
			* NavInternetResources
			* NavPeople
			* NavPublications
			* NavSoftware

			If you truly are creating a new section big enough that it needs its own navigation link, here is how they currently work:

	Each Nav template is made up of other templates as well as a category for pages that use that template. In the case of the NavArticles template, it contains the following:		Each Nav template is made up of other templates as well as a category for pages that use that template. In the case of the NavArticles template, it contains the following:
Line 22:		Line 42:
	</nowiki></pre>		</nowiki></pre>

	'''2016/8/24 Update:''' The "includeonly" tag just makes the template not show up in that category. I will work on a way to simplify this in the future.		'''2016/8/24 Update:''' The "includeonly" tag just makes the template not show up in that category. I will work on a way to simplify this in the future. Categories used to be part of the "Articles" section but to prevent Templates from showing up in the category, it had to be moved to the final big template.

	The Home template contains the link to the Main Page of this wiki (with some text before it to be shown on every page of the site), and a custom text for the link (so it says "Home" instead of "Main Page"):		The Home template contains the link to the Main Page of this wiki (with some text before it to be shown on every page of the site), and a custom text for the link (so it says "Home" instead of "Main Page"):
Line 83:		Line 103:

	<pre>		<pre>
	{{~~GameInfoBox~~ \|		{{InfoBox \|
	\| ~~picture~~ = Blochead.gif		\| name = Bloc Head
	~~\| author = ???~~		\| photo = Blochead.gif
	~~\| publisher = [[Computerware]]~~		\| year = 1982
	\| year= ~~1983~~		\| notes = A Q-bert type game.
	\| ~~media~~ = ~~Disk/Tape~~		\| infosource = Allen
	\| ~~requires = Color Computer 1,2,3, 16K RAM~~
	~~\| graphic = 256x192x2~~
	~~\| notes~~ =
	}}		}}
	</pre>		</pre>

	Then whatever code for "~~GameInfoBox~~" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{~~picture~~}}}</nowiki> was in the template.		Then whatever code for "InfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{photo}}}</nowiki> was in the template.

	'''NOTE:''' All the InfoBox templates are going to be cleaned up and made consistent with automatic categories and such.		'''NOTE:''' All the InfoBox templates are going to be cleaned up and made consistent with automatic categories and such.

			=== See Also ===
			For more details and examples, see [[InfoBox Templates]].

AllenHuffman at 15:02, 30 August 2016

2016-08-30T15:02:02Z

← Older revision		Revision as of 11:02, 30 August 2016
Line 15:		Line 15:
	</nowiki></pre>		</nowiki></pre>

	Each Nav template ~~contains references to~~ other templates as well as a category for pages that use that template. In the case of the NavArticles template, it contains the following:		Each Nav template is made up of other templates as well as a category for pages that use that template. In the case of the NavArticles template, it contains the following:

	<pre><nowiki>		<pre><nowiki>
Line 24:		Line 24:
	'''2016/8/24 Update:''' The "includeonly" tag just makes the template not show up in that category. I will work on a way to simplify this in the future.		'''2016/8/24 Update:''' The "includeonly" tag just makes the template not show up in that category. I will work on a way to simplify this in the future.

	Home contains the link to the Main Page of this wiki, and a custom text for the link (so it says "Home" instead of "Main Page"):		The Home template contains the link to the Main Page of this wiki (with some text before it to be shown on every page of the site), and a custom text for the link (so it says "Home" instead of "Main Page"):

	<pre><nowiki>		<pre><nowiki>
Line 47:		Line 47:
	This will just display a non-breaking space, dash, non-breaking space, then the current page name in bold. (" - {{PAGENAME}}"). The four dashes on the next line will create a horizontal line to separate the content of the page from the navigation links at the top.		This will just display a non-breaking space, dash, non-breaking space, then the current page name in bold. (" - {{PAGENAME}}"). The four dashes on the next line will create a horizontal line to separate the content of the page from the navigation links at the top.

	So, when you start a page in an existing section, be sure to start with the appropriate NavXXX template reference at the top. You can find it by editing a similar page in that section. If it is an entirely new section/category, you will have to create a new ~~NavTemplate~~.		So, when you start a page in an existing section, be sure to start with the appropriate NavXXX template reference at the top. You can find it by editing a similar page in that section. If it is an entirely new section/category, you will have to create a new NavXXX template.

	=== Creating a new Navigation Template ===		=== Creating a new Navigation Template ===

	If you are creating a new section of the site, create the new page (~~like~~ "Digitizers"), and add a reference to the soon-to-be-created NavTemplate at the top of the page, using the following format (~~like~~ "NavDigitizers" or "NavPrinters"):		If you are creating a new section of the site, create the new page (such as "Digitizers"), and add a reference to the soon-to-be-created NavTemplate at the top of the page, using the following format (such as "NavDigitizers" or "NavPrinters"):

	<pre><nowiki>		<pre><nowiki>
Line 64:		Line 64:
	</nowiki></pre>		</nowiki></pre>

	Section Name would something like "Digitizers" or "Printers". "<nowiki>{{PageName}}</nowiki>" is a special macro built in to the Wiki that will show the current page name. Save this, and you will get a link to the new empty SectionName and "PageName" will show up with the current page name. Click and edit the new SectionName and make it look like this "Articles" example above ~~(Category and link to the main SectionName page).~~		Section Name would something like "Digitizers" or "Printers" and should match the main page name for that section. "<nowiki>{{PageName}}</nowiki>" is a template that uses a special macro built in to the Wiki that will show the current page name. Save this, and you will get a link to the new empty SectionName and "PageName" will show up with the current page name. Click and edit the new SectionName and make it look like this "Articles" example above:

	<pre><nowiki>		<pre><nowiki>
Line 79:		Line 79:
	I am not sure if this is still relevant, but I also have this page: [[Using Navigation Templates]]		I am not sure if this is still relevant, but I also have this page: [[Using Navigation Templates]]

	== ~~Template Variables~~==		== InfoBox Templates ==
	Templates can also contain parameters, passed in as variables. There is a "Template:InfoBox" that does this. Inside the template, it can reference named variables by their name with three curly braces around them, like "<nowiki>{{{variablename}}}</nowiki>". When the template is called, variables are specified with "name=value" like this:		Templates can also contain parameters, passed in as variables. There is a "Template:InfoBox" that does this. Inside the template, it can reference named variables by their name with three curly braces around them, like "<nowiki>{{{variablename}}}</nowiki>". When the template is called, variables are specified with "name=value" like this:

Line 96:		Line 96:

	Then whatever code for "GameInfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{picture}}}</nowiki> was in the template.		Then whatever code for "GameInfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{picture}}}</nowiki> was in the template.

			'''NOTE:''' All the InfoBox templates are going to be cleaned up and made consistent with automatic categories and such.

AllenHuffman: /* Creating a new Navigation Template */

2016-08-24T16:54:01Z

Creating a new Navigation Template

← Older revision		Revision as of 12:54, 24 August 2016
Line 61:		Line 61:
	<pre><nowiki>		<pre><nowiki>
	{{Home}}{{SectionName}}{{PageName}}		{{Home}}{{SectionName}}{{PageName}}
			<includeonly>[[Category: SectionCategory]]</includeonly>
	</nowiki></pre>		</nowiki></pre>

Line 66:		Line 67:

	<pre><nowiki>		<pre><nowiki>
	~~[[Category: SectionName]]~~{{Delim}}[[PageName]]		{{Delim}}[[PageName]]
	</nowiki></pre>		</nowiki></pre>

AllenHuffman: /* Navigation Templates */

2016-08-24T16:52:42Z

Navigation Templates

← Older revision		Revision as of 12:52, 24 August 2016
Line 15:		Line 15:
	</nowiki></pre>		</nowiki></pre>

	Each Nav template contains references to other templates. In the case of the NavArticles template, it contains the following:		Each Nav template contains references to other templates as well as a category for pages that use that template. In the case of the NavArticles template, it contains the following:

	<pre><nowiki>		<pre><nowiki>
	{{Home}}{{Articles}}{{PageName}}		{{Home}}{{Articles}}{{PageName}}
			<includeonly>[[Category: Articles]]</includeonly>
	</nowiki></pre>		</nowiki></pre>

	~~And each of those contains actual Wiki tags and~~/~~or categories, as needed~~.		'''2016/8/24 Update:''' The "includeonly" tag just makes the template not show up in that category. I will work on a way to simplify this in the future.

	Home contains the link to the Main Page of this wiki, and a custom text for the link (so it says "Home" instead of "Main Page"):		Home contains the link to the Main Page of this wiki, and a custom text for the link (so it says "Home" instead of "Main Page"):
Line 32:		Line 33:

	<pre><nowiki>		<pre><nowiki>
	~~[[Category: Articles]]~~{{Delim}}[[Articles]]		{{Delim}}[[Articles]]
	</nowiki></pre>		</nowiki></pre>

	Above, it will first contain ~~a Category tag for the Articles section, then~~ a Delimeter (which is currently " - " for this Wiki), then a link to the top level page for Articles.		Above, it will first contain a Delimeter (which is currently " - " for this Wiki), then a link to the top level page for Articles.

	Lastly, is the PageName template:		Lastly, is the PageName template:

AllenHuffman: /* Template Variables */

2013-04-02T12:01:59Z

Template Variables

← Older revision		Revision as of 08:01, 2 April 2013
Line 80:		Line 80:
	Templates can also contain parameters, passed in as variables. There is a "Template:InfoBox" that does this. Inside the template, it can reference named variables by their name with three curly braces around them, like "<nowiki>{{{variablename}}}</nowiki>". When the template is called, variables are specified with "name=value" like this:		Templates can also contain parameters, passed in as variables. There is a "Template:InfoBox" that does this. Inside the template, it can reference named variables by their name with three curly braces around them, like "<nowiki>{{{variablename}}}</nowiki>". When the template is called, variables are specified with "name=value" like this:

	~~<nowiki>~~<pre>		<pre>
	{{GameInfoBox \|		{{GameInfoBox \|
	\| picture = Blochead.gif		\| picture = Blochead.gif
Line 91:		Line 91:
	\| notes =		\| notes =
	}}		}}
	</pre~~></nowiki~~>		</pre>

	Then whatever code for "GameInfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{picture}}}</nowiki> was in the template.		Then whatever code for "GameInfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{picture}}}</nowiki> was in the template.

AllenHuffman: /* Template Variables= */

2013-04-02T12:01:07Z

Template Variables=

← Older revision		Revision as of 08:01, 2 April 2013
Line 77:		Line 77:
	I am not sure if this is still relevant, but I also have this page: [[Using Navigation Templates]]		I am not sure if this is still relevant, but I also have this page: [[Using Navigation Templates]]

	== Template Variables===		== Template Variables==
	Templates can also contain parameters, passed in as variables. There is a "Template:InfoBox" that does this. Inside the template, it can reference named variables by their name with three curly braces around them, like "<nowiki>{{{variablename}}}</nowiki>". When the template is called, variables are specified with "name=value" like this:		Templates can also contain parameters, passed in as variables. There is a "Template:InfoBox" that does this. Inside the template, it can reference named variables by their name with three curly braces around them, like "<nowiki>{{{variablename}}}</nowiki>". When the template is called, variables are specified with "name=value" like this:

	<nowiki>		<nowiki><pre>
	{{GameInfoBox \|		{{GameInfoBox \|
	\| picture = Blochead.gif		\| picture = Blochead.gif
Line 91:		Line 91:
	\| notes =		\| notes =
	}}		}}
	</nowiki>		</pre></nowiki>

	Then whatever code for "GameInfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{picture}}}</nowiki> was in the template.		Then whatever code for "GameInfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{picture}}}</nowiki> was in the template.

AllenHuffman: /* Navigation Templates */

2013-04-02T12:00:33Z

Navigation Templates

← Older revision		Revision as of 08:00, 2 April 2013
Line 44:		Line 44:
	</nowiki></pre>		</nowiki></pre>

	This will just display a non-breaking space, dash, non-breaking space, then the current page name in bold. (" - {{PAGENAME}}")		This will just display a non-breaking space, dash, non-breaking space, then the current page name in bold. (" - {{PAGENAME}}"). The four dashes on the next line will create a horizontal line to separate the content of the page from the navigation links at the top.

	So, when you start a page in an existing section, be sure to start with the appropriate NavXXX template reference at the top. You can find it by editing a similar page in that section. If it is an entirely new section/category, you will have to create a new NavTemplate.		So, when you start a page in an existing section, be sure to start with the appropriate NavXXX template reference at the top. You can find it by editing a similar page in that section. If it is an entirely new section/category, you will have to create a new NavTemplate.

AllenHuffman at 11:59, 2 April 2013

2013-04-02T11:59:41Z

← Older revision		Revision as of 07:59, 2 April 2013
Line 1:		Line 1:
	{{NavHelp}}		{{NavHelp}}
	= Read Me First =		= Read Me First =
			Here are a few quick things to know about using this wiki.

			== Templates ==
			This MediWiki software supports Templates. A template is a page with the name "Template:TemplateName". Anything on that template page will appear anywhere you include it on another page as "<nowiki>{{TemplateName}}</nowiki>". For example, if there was a page called "Template:UltimateAnswer", and that page contained the text "42", you could include that text on any page just by adding:

			<nowiki>{{UltimateAnswer}}</nowiki>

			=== Navigation Templates ===
	A set of Wiki templates have been created to help with categories and navigation of this site. When creating a new page, or editing an existing one, please ensure that the top of the file begins with a Nav template, such as:		A set of Wiki templates have been created to help with categories and navigation of this site. When creating a new page, or editing an existing one, please ensure that the top of the file begins with a Nav template, such as:

Line 15:		Line 23:
	And each of those contains actual Wiki tags and/or categories, as needed.		And each of those contains actual Wiki tags and/or categories, as needed.

	Home contains:		Home contains the link to the Main Page of this wiki, and a custom text for the link (so it says "Home" instead of "Main Page"):

	<pre><nowiki>		<pre><nowiki>
	[[Main_Page\|Home]]		[[Main_Page\|Home]]
	</nowiki></pre>		</nowiki></pre>

	~~This means it will display the text "Home" which will link to "Main Page" (the default page of this wiki).~~

	Next is the Articles link:		Next is the Articles link:
Line 29:		Line 35:
	</nowiki></pre>		</nowiki></pre>

	Above, it will first contain a Category tag for the Articles section, then a Delimeter (which is ~~something like~~ " - " for this Wiki), then a link to the top level page for Articles.		Above, it will first contain a Category tag for the Articles section, then a Delimeter (which is currently " - " for this Wiki), then a link to the top level page for Articles.

	Lastly, is the PageName template:		Lastly, is the PageName template:
Line 40:		Line 46:
	This will just display a non-breaking space, dash, non-breaking space, then the current page name in bold. (" - {{PAGENAME}}")		This will just display a non-breaking space, dash, non-breaking space, then the current page name in bold. (" - {{PAGENAME}}")

	So, when you start a page in an existing section, be sure to start with the appropriate NavXXX template reference at the top.		So, when you start a page in an existing section, be sure to start with the appropriate NavXXX template reference at the top. You can find it by editing a similar page in that section. If it is an entirely new section/category, you will have to create a new NavTemplate.

	== Creating a new Navigation Template ==		=== Creating a new Navigation Template ===

	If you are creating a ~~whole~~ new section of the site, ~~start by making~~ a ~~Nav for it by including something~~ at the top like ~~this~~:		If you are creating a new section of the site, create the new page (like "Digitizers"), and add a reference to the soon-to-be-created NavTemplate at the top of the page, using the following format (like "NavDigitizers" or "NavPrinters"):

	<pre><nowiki>		<pre><nowiki>
Line 50:		Line 56:
	</nowiki></pre>		</nowiki></pre>

	When you save the page, that will be a new link. When you view this page, click on the new link, and fill out your new NavSectionName template like...		When you save the page, that will be a new link to an empty template page. When you view this page, click on the new link, and fill out your new NavSectionName template like...

	<pre><nowiki>		<pre><nowiki>
Line 56:		Line 62:
	</nowiki></pre>		</nowiki></pre>

	~~Then save~~, and you will get a link to the new SectionName~~, so click~~ and edit ~~that~~ and make it look like ~~the~~ "Articles" example above (Category and link to the main SectionName page).		Section Name would something like "Digitizers" or "Printers". "<nowiki>{{PageName}}</nowiki>" is a special macro built in to the Wiki that will show the current page name. Save this, and you will get a link to the new empty SectionName and "PageName" will show up with the current page name. Click and edit the new SectionName and make it look like this "Articles" example above (Category and link to the main SectionName page).

			<pre><nowiki>
			[[Category: SectionName]]{{Delim}}[[PageName]]
			</nowiki></pre>

			"<nowiki>[[PageName]]</nowiki>" is the link to the main page of that section, which is usually just the section name, and matches the category. i.e., if you create a category called "Digitizers", the main page should probably be "Digitizers".

	Once we get all this cleaned up, we will have an easier to navigate template. Plus, I can edit the Home link at any time to out a message or alert on every page of the site.		Once we get all this cleaned up, we will have an easier to navigate template. Plus, I can edit the Home link at any time to out a message or alert on every page of the site.
Line 62:		Line 74:
	There should be no pages without this navigation.		There should be no pages without this navigation.

	== See Also ==		=== See Also ===
	I am not sure if this is still relevant, but I also have this page: [[Using Navigation Templates]]		I am not sure if this is still relevant, but I also have this page: [[Using Navigation Templates]]

			== Template Variables===
			Templates can also contain parameters, passed in as variables. There is a "Template:InfoBox" that does this. Inside the template, it can reference named variables by their name with three curly braces around them, like "<nowiki>{{{variablename}}}</nowiki>". When the template is called, variables are specified with "name=value" like this:

			<nowiki>
			{{GameInfoBox \|
			\| picture = Blochead.gif
			\| author = ???
			\| publisher = [[Computerware]]
			\| year= 1983
			\| media = Disk/Tape
			\| requires = Color Computer 1,2,3, 16K RAM
			\| graphic = 256x192x2
			\| notes =
			}}
			</nowiki>

			Then whatever code for "GameInfoBox" will appear, with the values for each variable substituted where it goes. "Blochead.gif" would appear wherever <nowiki>{{{picture}}}</nowiki> was in the template.