A dungeon is a place or prison where people are held. Usually, they can be found underground.
This is an example repo illustration of a dungeon using Markdown on Github. In the dungeon the reader chooses which option to take and jumps into an appropriate page of the room that based on their choice. It is collaborative because the room is written by many authors.
Start a new game |
---|
You need install yarn.
- Clone the repo
git clone https://github.com/MakeContributions/markdown-dungeon.git
- Go to folder
cd markdown-dungeon
- Run install dependency
yarn
- Create a
.env.development
file in the project root folder and copy the format of.env.example
file. - To start the development server run:
yarn start
Ensure you are not using Power shell
- 🎉 Open your browser and go to http://localhost:8000/ or http://localhost:8000/___graphql
A floor is a folder and each floor is a collection of rooms and every room is a Markdown
file.
The Markdown capability links is used for up/down and go to another room, like below example.
[Go to Github dungeon](https://github.com/)
- Keep changes small
- Don't add an option without adding any gate for readers who decide on that option, so the dungeon will not be full of deadlinks. Instead, the last markdown file the reader reaches on any path of the room should not have any options.
- Add one or two sentences to an existing "page" (file) in the room.
- Add a new option to an existing choice point, and link that option to an existing "room" or "floor".
- Add a new option to an existing choice point, create a new "page" for that option, and add a sentence or two to the new "page".
- Add a couple of options to a current dead-end "page", and add a "page" or link to an existing "page" for each option.
Structure should be dungeon-name/floor-number/room-number
, please see below definition of each variables:
- dungeon-name: is a folder that contains floor number, should separate words with a dash(-), is alphanumeric. Example: normal-dungeon-1.
- floor-number: is a folder that contains room number, is numeric do not add 0 before the number.
1, 2, 3 // Compliance
01, 02, A3 // Non-Compliance
- room-number: is a markdown file, the name of the file should be in numeric, but if has sub-rooms of the room you could separate the room number with a dash(-), the sub room could be alphanumeric.
1, 2, 3-AF, 3-01 // Compliance
01A, 02*A3, A3+F // Non-Compliance
Folder or file name only accept all ASCII characters and the dash(-).
If you created a new dungeon please add in Start a new game, so the reader can go to your dungeon
If you want to get an idea of which option leads to what when contributing, look for
decision_tree.png
file under any dungeon folder, which contains a graphical view of that dungeon.
The links in this file must be relative links to continue working if the repository is forked.
Keep all lines 120 characters or less. Otherwise, the raw files will be difficult to read in the browser or on the command line, and the changes will be more difficult to review.
Insert blank lines between the different options so that the options are visually separated.