Posted February 19, 2015
Hello everyone,
You might be familiar with the Age of Wonders 1 manual addendum, a collection of tables and other useful information that was missing in the original manual for some reason. The Stratos Group, the company responsible for the manual and the addendum, no longer exists and all we have is a PDF version of a Microsoft Word document floating around the internet.
I decided to copy the addendum in an open format that can serve as the basis for whatever you might want to do with it. I have chosen reStructuredText (reST) as the markup language for several reasons. If you are not familiar with reST you can read more about it at the end of this post. Anyway, there is the link to the GitHub repository:
https://github.com/HiPhish/Game-Source-Documentation/blob/master/Age%20of%20Wonders/Addendum.rst
To view the source code you have to click the Raw button near the top.
I tried to stay as faithful to the original content and format as I could, so don't be surprised by the dead links. The text has been copy-pasted as well, so if you find any errors they are not mine.
________________________________________________
About reStructuredText, it is a markup language, similar to HTML for example: you type something in plain text and then an interpreter can render it with nice-looking formatting. Unlike HTML however, reST tries to be as non-intrusive as possible. If you look at my source code you will find that headings are underlined using different characters to represent different levels. Tables are drawn like tables using dashes and vertical lines instead of weird nested tags.
reST is easy for humans to write and read, yet at the same time it uses strict rules that allow a computer program to parse and correctly identify text elements. There is no standard as to how a reST document needs to be rendered, so the output by GitHub is just one possibility.
If you know Markdown you pretty much know reST, except that reST is better. You can read more about reST on the official site:
http://docutils.sourceforge.net/rst.html
You might be familiar with the Age of Wonders 1 manual addendum, a collection of tables and other useful information that was missing in the original manual for some reason. The Stratos Group, the company responsible for the manual and the addendum, no longer exists and all we have is a PDF version of a Microsoft Word document floating around the internet.
I decided to copy the addendum in an open format that can serve as the basis for whatever you might want to do with it. I have chosen reStructuredText (reST) as the markup language for several reasons. If you are not familiar with reST you can read more about it at the end of this post. Anyway, there is the link to the GitHub repository:
https://github.com/HiPhish/Game-Source-Documentation/blob/master/Age%20of%20Wonders/Addendum.rst
To view the source code you have to click the Raw button near the top.
I tried to stay as faithful to the original content and format as I could, so don't be surprised by the dead links. The text has been copy-pasted as well, so if you find any errors they are not mine.
________________________________________________
About reStructuredText, it is a markup language, similar to HTML for example: you type something in plain text and then an interpreter can render it with nice-looking formatting. Unlike HTML however, reST tries to be as non-intrusive as possible. If you look at my source code you will find that headings are underlined using different characters to represent different levels. Tables are drawn like tables using dashes and vertical lines instead of weird nested tags.
reST is easy for humans to write and read, yet at the same time it uses strict rules that allow a computer program to parse and correctly identify text elements. There is no standard as to how a reST document needs to be rendered, so the output by GitHub is just one possibility.
If you know Markdown you pretty much know reST, except that reST is better. You can read more about reST on the official site:
http://docutils.sourceforge.net/rst.html