CZ:How To: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Robert W King
imported>Robert W King
Line 15: Line 15:


The best templates are very flexible, very dynamic, and present information in a "clean" way.  This increases their reusability.  Templates that limit the information you can change are usually very poor, and have limited use.
The best templates are very flexible, very dynamic, and present information in a "clean" way.  This increases their reusability.  Templates that limit the information you can change are usually very poor, and have limited use.
<br/>
<br/><br/><br/>
<big>'''Starting a template'''</big>
<big>'''Starting a template'''</big>


Line 25: Line 25:


http://en.citizendium.org/wiki/Template:add , or [[Template:Add]]
http://en.citizendium.org/wiki/Template:add , or [[Template:Add]]
<br/>
<br/><br/><br/>
<big>'''Making the template work'''</big>
<big>'''Making the template work'''</big>



Revision as of 10:09, 13 March 2008

This 'CZ:How To page illustrates the wiki code needed to perform certain tasks and also lists many useful articles.

How to make a new template

Before creating a new template, there are several things that must be taken into consideration:

  • How will it be used?
  • Where will it be used?
  • How should it look?
  • How flexible will it be?
  • Is it needed?
  • What need is it fufilling?

Templates are extremely powerful tools for creating dynamic content that you want reproduced or changed with very little effort across a large number of pages. Templates can also be very data sensitive; that is, what kind of data you want to present may determine how your template looks and feels.

The best templates are very flexible, very dynamic, and present information in a "clean" way. This increases their reusability. Templates that limit the information you can change are usually very poor, and have limited use.


Starting a template

The first step in starting a template is determine what it should be called. This is more important than you think! After all, if you create a template called {{infobox_for_different_Wheat_germs_and_their_DNA_structures}} NOBODY will use it. It's too much of a hassle to implement.

Additionally, if you misname your template, it confuses people upon its use. For example, if you create a template called {{paper_colors}} and it actually shows paper dimensions, you will also confuse users (and possibly incite arguments!)

Once you have predetermined these factors, you start your template by creating a new document within the template namespace. Let's call this example "add". It will be used to add two numbers. The location is as follows:

http://en.citizendium.org/wiki/Template:add , or Template:Add


Making the template work

After you've created the new page, it's now ready for programming. After all, a blank template will do nothing.

Let's consider what we want the template to do. We're going to take two values, X and Y, and combine their values to produce a third value Z. In order to do this, we have to define these two variables, X and Y. We do this below:

{{{X}}} {{{Y}}}

Now, we have to input the logic to add the numbers. To make mathematical evaluations in wiki software, you must use the {{#expr:}} or "expression" template. It is implemented as such:

{{#expr: {{{X}}} + {{{Y}}} }}

This tells the template to evaluate the expression "{{{X}}} added to {{{Y}}}". Once this is complete, the template can be called as such:

{{add
|X=3
|Y=7
}}

Using the template, we should see the answer below is ten.

Template:Add

Of course, we could have just used the following within the template:

{{#expr: 3 + 7}}

But the problem with this design, is that using the template {{add}} will then always have produced "10", which isn't very flexible, is it? This way, any user can use the Add template to add any two numbers they'd like!

Please feel encouraged to test out our new template below, by clicking the "edit" next to the subheading.

Test add template below this line!

How to create a basic table (manually)

The table creation process uses the syntax below:

To create the actual table, use

{|

At this point, you can specificy specific style elements about your table, such as

  • having a border (by adding border="1")
  • setting border colors
  • setting table width
  • other CSS elements

After the table has been established, use

|

to create your first data cell. This also begins a new column. At this point, you can also

  • specify it's alignment
  • specify how many columns it will cover
  • apply other CSS style elements

To create a new row, simply use

|-

After creating as many columns and rows you wish, close your table by using

|}

A sample table code is below

{|border="1" width=40px 
|column 1, row 1
|align="center"|column 2, row 1
|-
|align="left"|column 1, row 2
|align="right"|column 2, row 2
|}

The table looks like this:

column 1, row 1 column 2, row 1
column 1, row 2 column 2, row 2

How to checklist articles

The basic instructions are located at CZ:Using the Subpages template. A weekly list of unchecklisted articles needing attendtion can be found at CZ:Unchecklisted_Articles.

How to delete an article

You can ask a constable to delete an article by using the speedydelete template. You can simply add {{speedydelete|Insert some reason here}} to the article/image space.

How to find editors

To find a list of editors in a particular Workgroup, go to the CZ:Workgroups page and clink on the editors link for the workgroup.

How to make arrows

Some arrows can be inserted by clicking on the appropriate arrow located on the bottom of edit pages. They can also be typed as shown by the examples below. Note that the math begin (<math>) and math end (</math>) tags do not need to immediately surround the arrow functions, they only need to be at the beginning and end of equations.

is made from <math>\rightarrow</math> or <math>\rarr</math> or &rarr;

is made from this <math>\leftarrow</math> or <math>\larr</math> or &larr;

is made from this <math>\leftrightarrow</math> or <math>\harr</math> or &harr;

is made from <math>\stackrel{\textstyle \leftarrow}{\rightarrow} </math>

is made from this <math>\uparrow</math>
is made from this <math>\downarrow</math>

How to make chemical equations

Note that buttons for superscripts and subscripts are located immediately above and below the edit text box when editing a page. To subscript something, just hi-light the text and click the subscript button.

This text

: 4NaPO<sub>3</sub> + 2SiO<sub>2</sub> + 10C → 2Na<sub>2</sub>SiO<sub>3</sub> + 10CO + P<sub>4</sub>

OR THIS TEXT

:<math> 4 \mathrm{NaPO}_3 + 2 \mathrm{SiO}_2 + 10\mathrm{C} \rarr 2 \mathrm{Na}_2\mathrm{SiO}_3 + 10\mathrm{CO} + \mathrm{P}_4 </math>

provides the following equation (note that colons indent the equation)

4NaPO3 + 2SiO2 + 10C → 2Na2SiO3 + 10CO + P4



How to make math equations (italic variables)

Simple algebraic equations

This text

:<math>\left(p + \frac{n^2 a}{V^2}\right)\left(V-nb\right) = nRT</math>

provides this mathematic formula

How to make integral equations

:<math>F(t) = \int_0^t f(x) \, dx.</math> gives this equation:

and this text, :<math>\int_a^b f(x) \, dx = F(b) - F(a).</math>, gives this equation:

How to make differential equations in dot notation

This text, :<math>\dot{x} = \sigma(y - x)\ ,</math> give this equation in dot notation

This text, :<math>\dot{x}=\frac{dx(t)}{dt}\ .</math> gives this equation

How to make summation equations

This text
:<math> X = \sum_{J=1|}^{n} \ c_JV_J. </math>

provides this equiation:

How to make subscripts

Note that buttons for superscripts and subscripts are located immediately above and below the edit text box when editing a page. To subscript something, just hi-light the text and click the subscript button.

Or, you can type the code yourself, thus X<sub>2</sub> yields X2.

How to make superscripts

Note that buttons for superscripts and subscripts are located immediately above and below the edit text box when editing a page. To subscript something, just hi-light the text and click the subscript button.

Or, you can type the code yourself, thus X<sup>2</sup> yields X2.

How to start a new article

Instructions for all methods are located at CZ:How to start a new article.

How to start a new proposal

Instructions for starting a new proposal can be found at CZ:Proposals/New.

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"|  |}