Difference between revisions of "Help:How to make a Topic page"

From Personal Science Wiki
Jump to navigation Jump to search
Line 1: Line 1:
To create a new topic page, you can either use the [[Form:Topic|Topic form]] or create it manually by pasting the following markdown elements to a page.  
+
This wiki offers a couple of templates that help maintain a consistent style, categorization and automatic linking through semantic information. If you want a new page to be a ''Topic'' page, the minimum information you need to add is the categorization as a tool. All other templates are optional, though we strongly encourage using them to improve findability.
 +
 
 +
== Using the visual editor to add topic templates to a page ==
 +
Depending on how you ended up on the page creation form the visual editor should already be the default. Otherwise, the visual editor can be found under the ''"Create"'' tab on the top right/middle of the page. A step-by-step guide of how to add all the right templates and information can be seen in the galleries below.
 +
 
 +
===Adding the category===
 +
<gallery>
 +
File:Set-page-category.png|Click on the hamburger menu on the top right of the editor and choose ''"Categories"''.
 +
File:Set-topics-category.png|Type ''"Topics"'' into the search bar and click "enter". The category tag should appear in the autocomplete option. If the category title is red, please check the spelling.Click ''"Apply changes"''. Now the category tag should appear on the bottom of your page.
 +
</gallery>
 +
 
 +
=== Adding the infobox ===
 +
The ''Topic'' category has no infobox. For more information, see [[Help:Semantic properties in Personal Science Wiki|Semantic properties in Personal Science Wiki]].
 +
 
 +
===Adding the Topic Queries===
 +
<gallery>
 +
File:Insert-template.png|Click on the ''"Insert"'' tab on top of the editor, then pick ''"Template"''.
 +
File:Topic-queries-properties.png|Type ''"Topic Queries"'' into the search bar. The template should appear in the autocomplete list. Choose the template and click ''"Insert"''. Do not add anything under ''"add more information"''. The queries will be automatically filled when another page refers to your page in their infobox. The Topic Queries template should now appear on the bottom of your page.
 +
</gallery>
 +
 
 +
===Adding further content===
 +
All other content can now be added and formatted as you wish. See the [https://www.mediawiki.org/wiki/Cheatsheet Cheatsheet] from MediaWiki for formatting help.
 +
 
 +
==Using the source code editor to add topic templates to a page==
 +
 
 +
* Adding the '''topic category''': <code><nowiki>[[Category:Topics]]</nowiki></code>
 +
** We recommend adding this at the bottom of the page,
 +
** This makes the page show up on the [[:Category:Topics|Topics overview page]]
 +
* Adding the '''footer queries''': <code><nowiki>{{Topic Queries}}</nowiki></code>
 +
** We recommend adding this at the bottom of the page
 +
* The ''Topic'' category has no infobox. For more information, see [[Help:Semantic properties in Personal Science Wiki|Semantic properties in Personal Science Wiki]].
  
 
==Elements of a Topic page==
 
==Elements of a Topic page==
* <nowiki>{{Topic Queries}}</nowiki>
 
** Add this to the bottom of the page.
 
** [[Template:Topic Queries|Link to the Topic Queries template]]
 
* <nowiki>[[Category:Topics]]</nowiki>
 
** Add this to the bottom of the page, below the Topic Queries.
 
** This tag makes the page show up on the [[:Category:Topics|Topics overview page]]
 
  
==How to make a page a Topic page if it already has elements of a different category?==
+
<gallery>
Remove any templates and category tags of other categories and add the Topic page elements specified above.
+
File:Category-topics-tag.png|Category-topics-tag.png|The category tag: A tag that assigns your page to the "Topics" category
 +
File:Topic-queries-example-narrow.png|The queries: A template which automatically displays all pages that link to your tool page in their infobox.  
 +
</gallery>
  
==Why does this category not have an infobox like the others?==
+
==How to turn a page to a topic page if it already in a different category?==
Topics are the broadest category; the more specific categories (Tools, Projects, People), can have topics as properties in their infobox, but not the other way round. If you want to connect a topic with a tool, person, or project, please go to the respective page and add the topic to the list of "related topics" in their infobox.
+
You can change the categorization of a page by removing any existing infobox/footer templates and category tags from a page and instead replace with (at least) the topic category tag as specified above. This will put the page in the topic category and remove it from the other categories.

Revision as of 10:32, 8 March 2022

This wiki offers a couple of templates that help maintain a consistent style, categorization and automatic linking through semantic information. If you want a new page to be a Topic page, the minimum information you need to add is the categorization as a tool. All other templates are optional, though we strongly encourage using them to improve findability.

Using the visual editor to add topic templates to a page

Depending on how you ended up on the page creation form the visual editor should already be the default. Otherwise, the visual editor can be found under the "Create" tab on the top right/middle of the page. A step-by-step guide of how to add all the right templates and information can be seen in the galleries below.

Adding the category

Adding the infobox

The Topic category has no infobox. For more information, see Semantic properties in Personal Science Wiki.

Adding the Topic Queries

Adding further content

All other content can now be added and formatted as you wish. See the Cheatsheet from MediaWiki for formatting help.

Using the source code editor to add topic templates to a page

  • Adding the topic category: [[Category:Topics]]
    • We recommend adding this at the bottom of the page,
    • This makes the page show up on the Topics overview page
  • Adding the footer queries: {{Topic Queries}}
    • We recommend adding this at the bottom of the page
  • The Topic category has no infobox. For more information, see Semantic properties in Personal Science Wiki.

Elements of a Topic page

How to turn a page to a topic page if it already in a different category?

You can change the categorization of a page by removing any existing infobox/footer templates and category tags from a page and instead replace with (at least) the topic category tag as specified above. This will put the page in the topic category and remove it from the other categories.