A Guide for New Editors

Hello, and thanks for your interest in the Wiki! Let’s get you familiar with how we work.

Firstly, we all hang out on the Mod Discord in the #wiki-discussions area - if you have questions, or even if you don't but are working on articles, please keep an eye out there.

Secondly, this guide is for a newbie, for a quick "reference" sheet listing commands, style guidelines, templates etc etc. please see here

## **Stages of Writing a Country Articles**

Most of the work we do on the wiki is writing articles for countries. That involves a few parts

For convenience, we split writing an article into 6 different
tasks – not everyone can or wants to do the same tasks, so you can choose the
tasks that suit you.

**Intro and Lore** - Writing summaries of a nation's history
using available sources including the info in-game (don’t forget the country
welcome screen!), localisation files, wiki timeline, the MLP show (if it’s a canon
nation) and asking the devs.

**Infobox and Tables** – Filling out all the information
into the tables – list of advisors, population, number of factories, resources
etc etc.

**Strategy and National Focus Discussion** – You will
learn about the nation's focus tree (can use console commands to activate them
quickly) and try it to learn what different things do. Writing about the
focuses and their effects. Explaining gameplay mechanics and decisions. Writing
about the country's neighbours, what threats or opportunities they present.
Summarising simple pros and cons of the nation. Summarising how a typical game
as this nation will proceed. A good example of this is here in Wittenland and here in Aquileia

**Comparison Tables** – Sometimes there are two mutually exclusive
paths you can take on a focus tree. We make tables to help players compare the
bonuses each route grants. A good example can be found here - (click the expand button to view the table)

**Code Nation Files Examined** – Hopefully, our writers
have learned everything about the nation in the *Strategy and National Focus*
Discussion state – however, nations can be complicated, and so sometimes
the best way to learn all its secrets and mechanics is to look at the HOI4 game
files to see how all the events and decisions work. Once we’ve checked these,
we put any missing information in the Strategy and National Focus sections.

**Final Nation Review** – Once an article is complete, we
give it to another wizard to check for issues, feedback, etc. The wizard may
fix these mistakes themselves or give some tasks that need to be done by the
original authors before they are satisfied.

## **Choosing a Task**

Wiki editors grab themselves a task by putting their name
down on the planning sheet.
Let’s have a look.

Here we can see a
list of country articles, which ones are highest priority, and the status of
each of the tasks. Green boxes are finished, Yellow are in Progress, and Red
are unassigned.

Write your name in one of the red boxes and change it to yellow
to grab that task. Once you’ve finished change it to green. For a newbie, we
recommend taking on the first two stages – **Infobox and Tables,** and **Intro**
and Lore**. Once you’ve done that at least once, you are ready to tackle more**
challenging parts of an article.

## **Getting Information**

There are three ways to get information for the Wiki – playing
the game, reading the game files and asking others.

### **Playing the Game**

Playing the game is of course a
good way to learn a nation but doing it properly can take hours. We often use
console commands to cheat our way through a nation – it's much faster – though there
is no substitute for at least one proper play through

Some notable console commands (to activate the console type `
button)

**Tdebug** – this will show you more
information on mousing over an area, including the all-important TAG – a tag is
a 3 letter code that identifies the nation in HOI4 code. For instance,
Equestria’s tag is EQS.

**Tag XXX** – this will switch you to playing
another nation – write the correct 3 letter code for their tag

**Focus.autocomplete** – this one will allow
you to complete focuses instantly. However, it also applies to the AI too, so
the best way to use this is to pause the game, activate it, complete some focuses,
and turn the command off, and then unpause the game.

**Event XXXXXXXXX** – this will activate an
event immediately. Event names are found in the HOI4 files. Usually in EaW we
use a *name.number* format for event names. For instance, *event equestria.100*
will activate event number 100 for Equestria (in this case the start of the
civil war)

### **Reading the Game Files**

All information about
nations is stored in the game files, and it can speed up your work a lot by
reading them. You can find the game files in one of two places

Steam -
/STEAM/STEAMAPPS/WORKSHOP/CONTENT/394360/1096008281/Equestria.zip

Manual - /MY DOCUMENTS/PARADOX
INTERACTIVE/HEARTS OF IRON IV/MODS

If you are using steam, unzip the folder into your desktop
or somewhere easier to work with. It should look something like this.

There are a few folders that are most relevant for you, the wiki
editor. For regular looking at the game files, we recommend a text editor such
as Notepad++ or Sublime and an image viewer like XnViewMP.

* **Localisation** (English Text) – this folder holds all the text for all the countries in the game – for learning about the lore, this is where to go. The files are in .yml format but should be openable by notepad or word – make sure to turn on Word Wrap.

*An Example of the Text in a Localisation File – This one contains the text*
for BAN – Blackrock Bandits

* **GFX** (graphics) – the GFX folder contains all the pictures in EaW. The ones of most relevance to you are the *Flags*, *Leaders*, *Goals* (focuses) and *Ideas* (National spirit) folders. EaW images are stored as DDS or TGA files, which are annoying to work with and can’t be uploaded to a wiki.Fortunately, we have a converted version of the graphics folder available for download here, with all images in PNG format

**Folders for More Advanced Wiki Editors –** If you are examining game code, you should be looking at these 3 folders.

* Events (all country popups)

* Common/Decisions (all decisions)

* Common/National\_Focus (all national Focus Trees)

### **Asking Developers**

We are lucky to have access to
the developers of EaW. Generally, developers are happy to be pinged to be asked
a specific question about something they have worked on, though you should
avoid pinging majors unless you know that non-majors don’t know the answer.
The best way to ask a question is

* Ask people in Discord who developed a certain nation. If no one knows, find a little helper who is online and ask them who developed it.

* Ping the developer of that nation with your question. Do not ping a role. For instance, it is ok to ping a little helper by their name. It is not ok to ping all the little helpers by typing @Little Helper

## **Using the Wiki Editor**

We are on the Fandom network of wikis. If you are going to
regularly edit it is good to get a fandom account. You can sign up in the top
right of the EaW Wiki page.

To edit a page, hit that edit button. Don’t worry about the
drop-down options – for us, the standard editor will do fine. The classic
editor may be nice in some cases but often it can’t render complex articles.

The edit window will show up. It is
mostly self-explanatory, but please note the **Source Editor** button in the
drop-down options. This allows us to see the raw wiki code. If I want to copy
something complicated from somewhere else, I should copy the code directly from
one article’s code to another article’s code using the source editor.

*The source editor shows the raw wiki code – highlighted*
in blue is the code for the country infobox at the top right of the article.
Pictures, tables, and links will also have code accessible here.

**A word of warning about the Wiki Editor** – The wiki
page editor is powerful, but at times buggy. It is easy to push the wrong
button and make the browser load a new page, or for it to crash, losing all
your in-progress work. Avoid grief with the following tips

For extensive writing, write your work in Word
and then copy it to the wiki

Be careful around tables – if the editor starts
behaving unusually – for example, refusing to delete something, or not responding
to keypresses, or otherwise behaving oddly, immediately stop, save your
changes, and try opening up the editor again to avoid it crashing. If the problem persists ask your
fellow Wizards to check the raw wiki code for table code glitches.

### **Using Templates**

Templates are powerful, automatic
ways to add styling and objects to the wiki. EaW has some templates we have written.
Let's look at a simple one. The flag template. This adds a tiny country flag and
a link to that country in the text.

To call a flag, type {{ whilst editing a Wiki page in the
standard editor. The insert template box appears

I will click the flag template. The
wiki will ask me what info I want in this template.

In this case, the template can accept two pieces of information.
I can learn more about what information to type in a template by clicking the “Get
info” button. In this case, I only need to fill in the country name in the
first box – Equestria.

 Equestria

All done! We also have templates for leader portraits and
many other useful features. You can change the settings on a template by double-clicking it.

## The 5 Commandments of EaW Wiki Writing

* **Make it useful** - Repeating information, especially uninteresting information, that you can already find in game is not that useful. For example - a description of the effects of every focus in a tree? Not useful. Highlighting some powerful focuses or focuses that have implications for strategy? Useful. Telling the player the effect of a focus they can already see on the focus tree? Not useful. Telling them about the secret event that has a chance of firing after they take it? Useful. Ask yourself what would you want to know from this wiki as a gamer.
* **Make it efficient, structured and easy to navigate** - People are reading to find specific information, not to be entertained by your writing. Be short and to the point. Organise longer information by using headings, bold, bullet points - anything to make the article less overwhelming and more structured for the player. Don't be afraid to use a different structure in one article to another - if certain pieces of information naturally go together in one article, but not another, act accordingly.
* **Be objective in style, but subjective in choosing and presenting info** - Keep an informational style, and be objective, but you must make subjective calls about what information is interesting, useful, or helpful. Sometimes subjective opinions are helpful - Don't be afraid to make general comments about what is valuable or important, especially about a broad strategic overview.
* **When in doubt, take inspiration from someone else** - not sure about how this section should be written, or what information you should include, or how long? Go check out other country pages that have already been reviewed - not every country page is the same, but you should find a style that works for the nation you are writing
* **Detail Gameplay, Not Story** - The lore section of the wiki should be filled with lavish historical detail, but the story that occurs once the game starts is not the focus of the article. Going into detail about the plot spoils the in-game experience of learning the detail there - we should focus on the gameplay elements, mechanics, decisions and only briefly mention the plot that leads to and results from these decisions.

### Congratulations on Reading this Far and Welcome to the Wiki Wizards! Please Rise for the Anthem!

**Cazzym**: Heads high, wizards!

Marching proud! *[whistle blows]*

All together now! Every one of you!

No wizard left behind!

Life is so grand at Our Wiki

We're always filled with cheer

We never have to look around

To know that we're all here

**Wizards**: At Our Wiki, at Our Wiki

We don't have to wait

To find out that our destiny

Is just to copy paste

**Cazzym**: Let's see those big, happy smiles!

Life is a smile at Our Wiki

Our job is so tame

Because when you've a template

Each articles the same.

**Wizards**: At Our Wiki, at Our Wiki

We dare not compete

Winning only breeds the worst

Ego-filled conceit

**Cazzym**: You see? Now everypony wins!

Life is a joy at Our Wiki

We're all equal here

No one is superior

And no one shakes in fear

**Wizards**: At Our Wiki, at Our Wiki

We write up some fanon

You can't break their vision

When there was no canon

**Cazzym**: Other majors argue

Do you ever wonder why?

When you think your war crime's special

You don't see eye-to-eye

There's just too many differences

That lead to disarray

But when you learn to act as one

It's like a holiday

**Wizards**: At Our Wiki, at Our Wiki

We don't complicate

When you learn to template

Life is oh, so great

Join in our utopia

Come out of the dark

Banded by wizardry

By our robe and hat!