Differences

This shows you the differences between two versions of the page.

--- conventions [2012/07/27 03:04] – [Content Checklist] ch1b1
+++ conventions [2019/12/11 04:49] (current) – switch to namespaced tags ch1b1
@@ Line 34: / Line 34: @@
   #REDIRECT where_the_page_should_point_to
+More tips on using links:
+  * Include links to pages that don't exist yet---this will encourage someone to create them.
+  * Create pages that are linked to but don't exist yet. An orange link is an invitation.
+  * Avoid changing page names and section titles, as others may link to them.
+  * If you and another contributor disagree on what the name of a page should be---i.e., your links to it have different names---just put in a redirect and be done with it.
 ==== Tag, You're It ====
@@ Line 40: / Line 46: @@
   {{tag>some tags here}}
-where each tag is separated by a space. Tag names may not have spaces in them. You might want to consider tagging pages about your locations with your username---that way, you can find them later.
+where each tag is separated by a space. Tag names may not have spaces in them. You might want to consider tagging pages about your locations with your username---that way, you can find them later. All tags are namespaced with colons. A leading colon uses the root namespace.
 Certain tags are magical---they will make the wiki software link to your page automatically. These magical tags include:
-  * ''location'': Anything which describes a point, area, or region in the world should be tagged as a location. There are several specific types of location tags. These tags should be included **in addition** to the ''location'' tag.
+  * '':location'': Anything which describes a point, area, or region in the world should be tagged as a location. There are several specific types of location tags. These tags should be included **in addition** to the ''location'' tag.
-    * ''home'': Any permanently-inhabited space, such as the one in which your character resides. You can have more than one home. Any page with this tag will be listed on the start page.
+    * '':home'': Any permanently-inhabited space, such as the one in which your character resides. You can have more than one home. Any page with this tag will be listed on the start page.
-    * ''landmark'': If you've spent five hours building a complicated model of something, and you want everyone to see it, include this tag. Landmarks are also listed on the start page.
+    * '':landmark'': If you've spent five hours building a complicated model of something, and you want everyone to see it, include this tag. Landmarks are also listed on the start page.
-  * ''player'': Your user page should contain this tag. User pages are of supreme importance and are linked to, prominently, on the [[start]] page.
+    * '':technology'': Machines can be art, too! It doesn't have to look good, but it does have to be useful. If you've built some technology at a //specific location// you want others to see and use, give it this tag.
-It is worth nothing that these magical tags all use the singular form---i.e., ''player'' instead of ''player<del>s</del>.''
+  * '':player'': Your user page should contain this tag. User pages are of supreme importance and are linked to, prominently, on the [[start]] page.
+It is worth nothing that these magical tags all use the singular form---i.e., '':player'' instead of '':player<del>s</del>.''
 There are other tags which are not magical right now, but if they become popular enough they will gain their own wiki page. These tags are:
-  * ''info'': Generic information about the world that is not location-specific.
+  * '':info'': Generic information about the world that is not location-specific.
-  * ''blueprint'': Plans, schematics, and designs.
+  * '':blueprint'': Plans, schematics, and designs.
-  * ''region'': An article describing a large area of the world.
+  * '':region'': An article describing a large area of the world.
-  * ''your_tag'': If you want to propose more standardized tags, include them here!
+  * '':your_tag'': If you want to propose more standardized tags, include them here!
-Tag magic is easy to learn---the incantation is relatively straightforward. Anyone can automatically generate a list of pages with one or more tags. If you've tagged a bunch of pages as ''butterflies'' and you want to list all pages which are tagged ''butterflies,'' just use
+Tag magic is easy to learn---the incantation is relatively straightforward. Anyone can automatically generate a list of pages with one or more tags. If you've tagged a bunch of pages as '':butterflies'' and you want to list all pages which are tagged '':butterflies,'' just use
-  {{topic>butterflies}}
+  {{topic>:butterflies}}
 and such a list will be inserted into your page. The syntax for the tagging engine is described on an [[http://www.dokuwiki.org/plugin:tag|external website]] and not on the main syntax page.
 ==== Content Checklist ====
 The content of the page is left largely to the discretion of the author, but here are a few suggestions.
-  * Use lots of links. An unlinked-to page has no visitors and begins to rust.
-    * Include links to pages that don't exist yet---this will encourage someone to create them.
-    * Create pages that are linked to but don't exist yet. An orange link is an invitation.
-    * Avoid changing page names and section titles, as others may link to them.
   * Use lots of images... but many snapshots of the same thing should go in a slide-show.
   * Use a spell checker.
@@ Line 70: / Line 73: @@
       * Make use of section headings and, if you're linking to a very long page, anchor links.
       * Consider using topic pages such as [[DTA Minecarts]] which redirect to a subsection of another page (in this case, ''Dwarven Transit Authority#Minecarts'')
+      * When pages get too long, split them.
   * Pages which describe locations should...
       * include coordinates and directions
@@ Line 107: / Line 111: @@
 The gallery plugin can be used to view an entire [[#namespaces|namespace]] as a slide-show. It can also include just a single image or a wild-card image search. The media manager includes an option to "Add namespace as gallery," which will insert a basic photo gallery of the selected namespace. Read the [[http://www.dokuwiki.org/plugin:gallery|gallery syntax]] for the full list of features---there are lots of options. A good example of the syntax is included on the [[featured screenshots]] page:
   {{gallery> screenshot:featured?&lightbox&3&showname&modsort&reverse }}
-inserts a photo gallery of all photos in the ''screenshot:featured'' namespace. Three columns of images are included per row, sorted by upload date with the most recent first. When clicked, the image will pop up in a full-screen slide-show view that can be scrolled through with the arrow keys---this is the ''lightbox'' option. Sadly, it is not possible to include captions using the ''gallery'' plugin.
+inserts a photo gallery of all photos in the ''screenshot:featured'' namespace. Three columns of images are included per row, sorted by upload date with the most recent first. When clicked, the image will pop up in a full-screen slide-show view that can be scrolled through with the arrow keys---this is the ''lightbox'' option.
+It is also possible to insert just a single image using ''gallery''. If multiple ''gallery'' invocations are given on the same page, you can scroll through all of the images in the popup ''lightbox'' view. Sadly, it is not possible to include captions using the ''gallery'' plugin.

Minecraft@TheParadox.Us

User Tools

Site Tools

Differences

Page Tools