How_To_Edit - Atlas of Economic Models
 

How To Edit

Before editing a page, please take a look at the Community_Norms page for the site's 'code of conduct'.

This section applies to both newly-created and existing model pages. To edit a page, click on the "Edit" link either in the box on the right-hand side of the page or in the options bar at the bottom of the page. You must be logged-in to edit a page. Use the "Preview" button to check layout and formatting, which can be especially useful when inputting maths or other complex mark-up (although some formatting e.g. the @VARIABLE@ subsitution macro will not be displayed properly until the page has been saved).

When editing an existing page please acknowledge yourself in the "Additional Contributors" section of the AtlasModelTemplate and make a brief comment summarising the changes you have made.

To experiment with wiki markup, go to the WikiSandBox and then click on "Edit" either in the box on the right-hand side or at the bottom of the page. Use your browser's "open a new window with this link" feature on the word "WikiSandBox", so you can keep the Help pages open side-by-side with the editing window.

Hint: To see the mark-up behind the displayed text on an existing page select "Raw Text" from the "More Actions" drop-down menu at the bottom of the page. This is especially helpful when you're just getting started as it shows the difference between the input and the final display.

Below are some explanations of the common editing tools. For a more detailed list see HelpOnEditing. For a quick reference guide to the main elements of Wiki mark-up see SyntaxReference. To learn more about the wiki environment see HelpOnWikis.

Formatting

HelpOnFormatting

Basic text formatting including bold, italics, sub/superscript and colours.

Lists

HelpOnLists

Using bulleted, numbered and bulletless lists.

Headings

HelpOnHeadings

Using section headings and numbered section headings.

The AtlasModelTemplate uses the [[TableOfContents]] macro to create a table of contents using the section headings, so will automatically give the contents list as

1. Model title

  1. Introduction
  2. Model
  3. Solving
  4. Example
  5. Applications and Extensions

However, it can be useful to further divide up the sections to make it easier for the reader to follow, which are then incorporated into the table of contents. Compare the table of contents and the section headings on this page as an example.

Maths

HelpOnMaths

The maths mark-up (closely related to LaTeX) is distinguished from normal text by enclosing it with double dollar signs. It can either be written in line with normal text or on a line of its own. However, as with normal text at the same indent, maths will run on the same line unless a line break [[BR]] is inserted at the end of the line or a blank line is left between equations.

NB

  • If using Internet Explorer, in order to display maths correctly you will be prompted to download the MathPlayer plug-in.

  • Some maths mark-up will not display properly if the page is in #format wiki, so check that it has not been included as part of the page template in the 'raw text' right at the top of the page (it is not part of the AtlasModelTemplate).

Linking pages and graphics

HelpOnLinking

To link to an internal page simply type the page name in the form PageName or ["Page Name"]. Take care that the link is correctly capitalised and takes any spaces or underscores _ into account. For example, the page http://atlas.openeconomics.net/HelpOnLinking can be accessed by either HelpOnLinking or ["HelpOnLinking"] but http://atlas.openeconomics.net/Romer_Ideas_Model can only be accessed by Romer_Ideas_Model and not Romer_Ideas_Model since this is not a valid WikiName.

It is also possible to link to internal pages using a different keyword, external pages and to insert graphics.

Tables

HelpOnTables

Tables are created using || to mark the start and finish of each column. There are a variety of options, including cells which span several rows or columns and many different text formats.