How to use the Army Editor

The army editor is entirely controlled by typing text in the editor box on the left side of the page. As you type, it interprets the text and formats the army list on the right side of the page.

It doesn't know the rules, units or points costs of your game - you have to type those in.

Indentation

Indentation, that is the number of spaces at the start of each line, controls how each line is interpreted.

No spaces
Detachment (e.g. Battalion). The editor doesn't have any knowledge of what detachments are - you need to type the name.
1 space
Battlefield roles (e.g. Heavy Support). Again, the editor doesn't know what roles are - you need to type the name.
2 spaces
Unit (e.g. Tactical Squad). You need to type in the unit type, and you'll probably want to include points cost and number of models (see below).
3 spaces
Unit option (e.g. Flamer). You need to type in what the option is, and you'll probably want to include points cost and number taken.
4+ spaces
Now you're entering into the unknown!

Points costs

You can include a points value in any line by typing a number inside square brackets. (Normally you would only do this on unit or option lines)

You can include a multiplier in a line by typing 'x' followed by a number. This would indicate the number of models or options taken. This only makes sense on a line with a points value in it!

Example:

  Infantry Squad [7] x5
   Flamethrower [12]
      
This describes an Infantry Squad. It has 5 models costing 7 points each, plus 1 Flamethrower which costs 12 points.

The army editor finds all the points costs in your list, multiplies and adds them up, and displays totals as you type.

Headers

A line which starts with some number of '#' characters is turned into a heading. You can put one anywhere but it mostly only makes sense at the top of the list. The heading size depends on the number of '#'.

Annotations

A line which contains a ':' is turned into italic text. This is useful for adding notes to detachments or units.

Advanced - Styling

You can add custom CSS formatting to your roster. Start a line with '!' followed by a selector and rules in curly brackets. Due to limitations of the editor (or laziness on my part) each selector + rules must be on a single line.

Rules are automatically scoped to only apply to the display/print parts of the editor.

For example, these rules will attempt to put detachments in two columns:

! .detachment { width: 49%; float: left; }
! .totalrow {clear: both; width: 98%; }
! .detachment.drop1 {margin-top:0;}
    

Printing

Use the 'print' command on your browser to print the roster. It will only print the formatted display, not the editor. I like to adjust the scaling in my print options to fit the list neatly onto pages.

Saving and Loading

The army editor uses local storage in the browser to remember the list you're working on. If you come back to the page it will show the last list you were in.

To save a list outside of the browser, select all of the text in the editor, copy it, and paste it into a text file on your computer.

Similarly to load a list, copy all the text from a text file you saved previously, and paste it into the army editor.