diff --git a/.gitignore b/.gitignore index f8892fd..9756264 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,4 @@ -trac -output -_book -node_modules +venv +site *.orig diff --git a/README.md b/README.md index 1da1773..67fa908 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,29 @@ -Build the Design Document using GitBook: -``` -npm install gitbook-cli -g -gitbook build -``` +# Contributing + +Contributing to the Design Document is possible for everyone, and is in many +ways similar to contributing to the game. We want the contributions to be +easy to perform and easy to review. In the future, we will look for a person +able to manage the evolution of this document, and the quality of contributions +and interactions with the reviewers will be a decisive factor in the choice +of the person. + +Contributing is done by submitting a pull request to the DD repository. +NB: Update this part when this becomes official, in order to use the correct +vocabulary for the Phabricator workflow etc. + +Small contributions, for fixing typos or style, will be accepted. Copy-pasting +from a former version of the document or from other sources (see +[Links and References](book/links.md)) will be accepted if a link to the source is +provided in the commit message. + +Bigger contributions, like proposals of a new feature, will be reviewed if +they come with a proof-of-concept that allows us to test the proposal. It can +be a patch, a mod, an edited image, etc. The proof-of-concept does not need +to be committable to the game source repository, it only needs to display +accurately the feature proposal. Please be aware that those contributions will +be more difficult to review and might need lengthy discussions and refinements. + +# Building the DD +Build the Design Document using MkDocs: +- Install the tool with `pip install mkdocs` in a virtualenv or globally. +- Build the DD with `mkdocs build` diff --git a/book.json b/book.json deleted file mode 100644 index 0f0aa95..0000000 --- a/book.json +++ /dev/null @@ -1,9 +0,0 @@ -{ - "root": "book/", - "title": "0 A.D. Design Document", - "author": "Wildfire Games", - "plugins": [ - "-sharing", - "alerts", - "creativecommons"] -} diff --git a/book/CONTRIBUTING.md b/book/CONTRIBUTING.md deleted file mode 100644 index 2719be3..0000000 --- a/book/CONTRIBUTING.md +++ /dev/null @@ -1,25 +0,0 @@ -Contributing -============ - -Contributing to the Design Document is possible for everyone, and is in many -ways similar to contributing to the game. We want the contributions to be -easy to perform and easy to review. In the future, we will look for a person -able to manage the evolution of this document, and the quality of contributions -and interactions with the reviewers will be a decisive factor in the choice -of the person. - -Contributing is done by submitting a pull request to the DD repository. -NB: Update this part when this becomes official, in order to use the correct -vocabulary for the Phabricator workflow etc. - -Small contributions, for fixing typos or style, will be accepted. Copy-pasting -from a former version of the document or from other sources (see -[Links and References](LINKS.md)) will be accepted if a link to the source is -provided in the commit message. - -Bigger contributions, like proposals of a new feature, will be reviewed if -they come with a proof-of-concept that allows us to test the proposal. It can -be a patch, a mod, an edited image, etc. The proof-of-concept does not need -to be committable to the game source repository, it only needs to display -accurately the feature proposal. Please be aware that those contributions will -be more difficult to review and might need lengthy discussions and refinements. diff --git a/book/LINKS.md b/book/LINKS.md deleted file mode 100644 index e60d891..0000000 --- a/book/LINKS.md +++ /dev/null @@ -1,15 +0,0 @@ -Links and References -==================== - -This Design Document is still a work in progress and is based on several -iterations of the text, as well as scattered information across our -development forums, wiki, etc. - -Here is a collection of a few references that might be useful for the -contributor or the reader who is curious about the origins of the document. - -* Our Trac wiki: https://trac.wildfiregames.com - * [Previous version of the DD](https://trac.wildfiregames.com/wiki/Design_Document) - * [Attempt at an update](https://trac.wildfiregames.com/wiki/DDv3WIP) - * [Exhaustive list of all pages of the wiki](https://trac.wildfiregames.com/wiki/TitleIndex) -* Our forums: https://wildfiregames.com/forum diff --git a/book/README.md b/book/README.md deleted file mode 100644 index 8535105..0000000 --- a/book/README.md +++ /dev/null @@ -1,8 +0,0 @@ -# 0 A.D. Design Document - -## Licensing and Disclaimer - -{% creativecommons type="by-sa" %} -{% endcreativecommons %} - -The info contained in this Design Document is provided as-is. It represents the current plan for 0 A.D. but the final game might not be exactly as described here due to for example issues found when balancing the game or features cut to make it possible to release the game in a reasonable time. diff --git a/book/SUMMARY.md b/book/SUMMARY.md deleted file mode 100644 index 57d0199..0000000 --- a/book/SUMMARY.md +++ /dev/null @@ -1,35 +0,0 @@ -# Summary - -* [0 A.D. Design Document](README.md) - -* [Links and References](LINKS.md) - -* [Contributing](CONTRIBUTING.md) - -* [Gameplay Design](gameplay/README.md) - * Main concepts - * [0 A.D. - The Vision](gameplay/main/vision.md) - * [War Story](gameplay/main/war-story.md) - * [Territories](gameplay/main/territories.md) - * [Capturing](gameplay/main/capturing.md) - * [Formations](gameplay/main/formations.md) - * Elements - * [Maps](gameplay/elements/maps.md) - * [Structures](gameplay/elements/structures.md) - * [Entities](gameplay/elements/entities.md) - * Civilizations - * [Athenians](gameplay/civs/athenians.md) - * [Britons](gameplay/civs/britons.md) - * [Carthaginians](gameplay/civs/carthaginians.md) - * [Gauls](gameplay/civs/gauls.md) - * [Iberians](gameplay/civs/iberians.md) - * [Macedonians](gameplay/civs/macedonians.md) - * [Mauryans](gameplay/civs/mauryans.md) - * [Persians](gameplay/civs/persians.md) - * [Ptolemies](gameplay/civs/ptolemies.md) - * [Romans](gameplay/civs/romans.md) - * [Seleucids](gameplay/civs/seleucids.md) - * [Spartans](gameplay/civs/spartans.md) -* [Technical Design](technical/README.md) - * [General settings](technical/settings.md) - * [Game settings and setup](part2/gamesetup.md) diff --git a/book/gameplay/main/formations.md b/book/gameplay/main/formations.md index efb7ec2..43ae278 100644 --- a/book/gameplay/main/formations.md +++ b/book/gameplay/main/formations.md @@ -1,10 +1,10 @@ Formations ========== -> **[danger] Implementation status** -> -> This page is a work in progress. Assume that nothing described here is -> finalised yet and everything could work completely different in the end. +!!! warning + + This page is a work in progress. Assume that nothing described here is + finalised yet and everything could work completely different in the end. # Current state and Goal diff --git a/book/gameplay/main/territories.md b/book/gameplay/main/territories.md index cf25650..2f290fb 100644 --- a/book/gameplay/main/territories.md +++ b/book/gameplay/main/territories.md @@ -1,10 +1,10 @@ TERRITORIES =========== -> **[warning] Implementation status** -> -> This page describes a feature that is implemented, but the implementation -> significantly differs from the text here. The text is to be updated. +!!! warning + + This page describes a feature that is implemented, but the implementation + significantly differs from the text here. The text is to be updated. ![Territories3.jpg](territories/Territories3.jpg) diff --git a/book/index.md b/book/index.md new file mode 100644 index 0000000..f35b599 --- /dev/null +++ b/book/index.md @@ -0,0 +1,24 @@ +0 A.D. Design Document +====================== + +## Licensing and Disclaimer + +[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-sa/4.0/) +This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. + +The info contained in this Design Document is provided as-is. It represents the current plan for 0 A.D. but the final game might not be exactly as described here due to for example issues found when balancing the game or features cut to make it possible to release the game in a reasonable time. + +## Links and References + +This Design Document is still a work in progress and is based on several +iterations of the text, as well as scattered information across our +development forums, wiki, etc. + +Here is a collection of a few references that might be useful for the +contributor or the reader who is curious about the origins of the document. + +* Our Trac wiki: + * [Previous version of the DD](https://trac.wildfiregames.com/wiki/Design_Document) + * [Attempt at an update](https://trac.wildfiregames.com/wiki/DDv3WIP) + * [Exhaustive list of all pages of the wiki](https://trac.wildfiregames.com/wiki/TitleIndex) +* [Our forums](https://wildfiregames.com/forum) diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..7ad46a6 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,37 @@ +site_name: 0 A.D. Design Document +site_author: Wildfire Games +repo_url: https://code.wildfiregames.com/source/design/ +repo_name: Contributing +use_directory_urls: false + +docs_dir: book +markdown_extensions: +- admonition + +nav: +- Gameplay - Main concepts: + - '0 A.D. The Vision': gameplay/main/vision.md + - 'War Story': gameplay/main/war-story.md + - 'Territories': gameplay/main/territories.md + - 'Capturing': gameplay/main/capturing.md + - 'Formations': gameplay/main/formations.md +- Gameplay Elements: + - 'Maps': gameplay/elements/maps.md + - 'Structures': gameplay/elements/structures.md + - 'Entities': gameplay/elements/entities.md +- Civilizations: + - 'Athenians': gameplay/civs/athenians.md + - 'Britons': gameplay/civs/britons.md + - 'Carthaginians': gameplay/civs/carthaginians.md + - 'Gauls': gameplay/civs/gauls.md + - 'Iberians': gameplay/civs/iberians.md + - 'Macedonians': gameplay/civs/macedonians.md + - 'Mauryans': gameplay/civs/mauryans.md + - 'Persians': gameplay/civs/persians.md + - 'Ptolemies': gameplay/civs/ptolemies.md + - 'Romans': gameplay/civs/romans.md + - 'Seleucids': gameplay/civs/seleucids.md + - 'Spartans': gameplay/civs/spartans.md +- Technical Design: + - 'General settings': technical/settings.md + - 'Game settings and setup': technical/gamesetup.md