CZ:Technical Help: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Larry Sanger
No edit summary
m (Text replacement - "CZ:Article Mechanics" to "CZ:Article mechanics")
 
(18 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Technical Help}}
{{seealso|CZ:Technical|CZ:Technical Team}}
 
__NOTOC__
__NOTOC__
{|align="center" cellpadding="10" style="width:70%; border: 1px solid #aaa; margin:20px; font-size: 90%;"
{|align="center" cellpadding="10" style="width:70%; border: 1px solid #aaa; margin:20px; font-size: 90%;"
|MediaWiki--the software that runs this wiki--has an undeserved reputation for difficulty of use.  You ''can'' just dive in and start typing the way way you'd type an e-mail.  Come to this page, however, for a jumping-off place to technical instructions.
|MediaWiki--the software that runs this wiki--has an undeserved reputation for difficulty of use.  You ''can'' just dive in and start typing the way way you'd type an e-mail.  Come to this page, however, for a jumping-off place to technical instructions.
|-
|<big>Most important here is our guide to the wiki code: [[CZ:how to edit an article|how to edit an article]].
Don't want to learn the code?  Then [[CZ:email us an article in word processor format|email us an article in word processor format]]!</big>
|}
|}


== Editing helps ==
== Editing helps ==
; [[CZ:How to edit an article|How to edit an article]]
; [[CZ:How to edit an article|How to edit an article]]
: Our local manual for MediaWiki, not to be confused with our style guide, [[CZ:Article Mechanics|Article Mechanics]].  Also useful: [http://meta.wikimedia.org/wiki/Help:Contents MediaWiki help] and [http://en.wikipedia.org/wiki/Help:Contents Wikipedia help]
: The wiki code!  How do you use <code><nowiki>[[this]], ''this'', [http://citizendium.org this], or ==This==</nowiki></code> ?  Learn here, in our local manual for MediaWiki, not to be confused with our style guide, [[CZ:Article mechanics|Article Mechanics]].  Also useful: [http://meta.wikimedia.org/wiki/Help:Contents MediaWiki help] and [http://en.wikipedia.org/wiki/Help:Contents Wikipedia help]


; [[CZ:Searching|Searching]]
; [[CZ:Searching|Searching]]
: How to use the search box (in the upper left).
: How to use the search box (in the upper left).
; [[CZ:Enhancing your editing with javascript extensions|Enhancing your editing with javascript extensions]]
: Some software enhancements you can include for your personal use.


; [[CZ:Templates|Templates]]
; [[CZ:Templates|Templates]]
Line 25: Line 24:
:* [[CZ:Citation templates|Citation templates]] - many templates are available for citing books, etc.
:* [[CZ:Citation templates|Citation templates]] - many templates are available for citing books, etc.
:* [[CZ:Symbols|Symbols]] - but these are also found beneath the edit box
:* [[CZ:Symbols|Symbols]] - but these are also found beneath the edit box
:* [[CZ:How_to_display_foreign_characters|How to display foreign characters]] - what to do if your browser won't show you e.g. Asian fonts correctly.
:* [[CZ:Enhancing your editing with javascript extensions|Enhancing your editing with javascript extensions]]
:* [[Help:Displaying mathematical formulas | Math]] - formatting math
:* [[CZ:How to make tables|How to make tables]] - displaying information in a tabular format


== Subpage and checklist technical help ==
== Subpage and checklist technical help ==
A unique feature of the ''Citizendium'' is that we use [[CZ:subpages|subpages]] for reference information of different types.  As a result, we have to connect all the subpages together and with the main page.  Also, we have an article "checklist," or metadata template, which tracks things like the article's quality and its workgroups.
A unique feature of the ''Citizendium'' is that we use [[CZ:subpages|subpages]] for reference information of different types.  As a result, we have to connect all the subpages together, and to the article's main page.  We have an article "checklist," or metadata template, which helps do this, and also tracks things like the article's quality and its workgroups.
 
; [[CZ:Article structure|Article structure]]
: A general introduction to the structure of an article, including subpages, the metadata, etc.
 
; [[CZ:Using the Subpages template|Using the Subpages template]]
; [[CZ:Using the Subpages template|Using the Subpages template]]
: The main technical guide to subpages and the metadata page.
: The main technical guide to subpages and the metadata page.
Line 37: Line 44:
: Must-read for anyone filling out the checklist (now found on "metadata" pages).  The checklist includes data about the article workgroups, status, etc.
: Must-read for anyone filling out the checklist (now found on "metadata" pages).  The checklist includes data about the article workgroups, status, etc.


; {{tl|Subpages}} and {{tl|Checklist}} templates
; {{tl|Subpages}} template
: Two of our most-used templates.  Not generally editable.
: The most important template in the subpage system.  Not generally editable.


== Help for programmers ==
== Help for programmers ==
; [[CZ:Downloads|Downloads]]
; [[CZ:Downloads|Downloads]]
: The contents of CZ available for programmers who want to make their own copy.  We would appreciate it if multiple backups of our content existed around the world, if disaster should strike our Internet host (not too likely, that).
: The contents of CZ available for programmers who want to make their own copy.  We would appreciate it if multiple backups of our content existed around the world, if disaster should strike our Internet host (not too likely, that).
; <span class=plainlinks>[http://trac.citizendium.org/ Bug reporting and feature requests]</span>
: Did you spot a software bug?  Have a feature request?  Report it here.
; <span class=plainlinks>[https://lists.purdue.edu/mailman/listinfo/citizendium-tools Citizendium-Tools]</span>
: The CZ technical mailing list.


;[[CZ:Technical Team Workgroup|Technical Team Workgroup]]
;[[CZ:Technical Team Workgroup|Technical Team Workgroup]]
: A wiki home page for our volunteer technical crew.  (Not well developed at present.)
: A wiki home page for our volunteer technical crew.  (Not well developed at present.)


;[[CZ:Extensions|Extensions]]
; [[CZ:Templates|Templates]]
:We use these add-ons to MediaWiki, the software that runs the wiki.
:A conical list of templates employed at CZ (still developing.)
 
{{Technical Help}}

Latest revision as of 16:01, 5 March 2024

See also: CZ:Technical and CZ:Technical Team
MediaWiki--the software that runs this wiki--has an undeserved reputation for difficulty of use. You can just dive in and start typing the way way you'd type an e-mail. Come to this page, however, for a jumping-off place to technical instructions.
Most important here is our guide to the wiki code: how to edit an article.

Don't want to learn the code? Then email us an article in word processor format!

Editing helps

How to edit an article
The wiki code! How do you use [[this]], ''this'', [http://citizendium.org this], or ==This== ? Learn here, in our local manual for MediaWiki, not to be confused with our style guide, Article Mechanics. Also useful: MediaWiki help and Wikipedia help
Searching
How to use the search box (in the upper left).
Templates
We use many "templates," a short piece of wiki code which, when saved, adds in long pieces of text (or code). It's a space- and labor-saver.
Other editing utilities
Here are a few more pages that may be of help in writing articles:

Subpage and checklist technical help

A unique feature of the Citizendium is that we use subpages for reference information of different types. As a result, we have to connect all the subpages together, and to the article's main page. We have an article "checklist," or metadata template, which helps do this, and also tracks things like the article's quality and its workgroups.

Article structure
A general introduction to the structure of an article, including subpages, the metadata, etc.
Using the Subpages template
The main technical guide to subpages and the metadata page.
Start article with subpages
A tool that makes starting a "subpagified" article as painless as possible.
The Article Checklist
Must-read for anyone filling out the checklist (now found on "metadata" pages). The checklist includes data about the article workgroups, status, etc.
{{Subpages}} template
The most important template in the subpage system. Not generally editable.

Help for programmers

Downloads
The contents of CZ available for programmers who want to make their own copy. We would appreciate it if multiple backups of our content existed around the world, if disaster should strike our Internet host (not too likely, that).
Technical Team Workgroup
A wiki home page for our volunteer technical crew. (Not well developed at present.)
Templates
A conical list of templates employed at CZ (still developing.)


Citizendium Technical Help
How to edit an article | Searching | Start article with subpages
The Article Checklist | Subpage template

|width=10% align=center style="background:#F5F5F5"|  |}