{"id":13693043,"url":"https://github.com/MakeContributions/markdown-dungeon","last_synced_at":"2025-05-02T21:31:13.162Z","repository":{"id":37802224,"uuid":"275609795","full_name":"MakeContributions/markdown-dungeon","owner":"MakeContributions","description":"This is an example that how to use Markdown creating a dungeon, please give a ⭐","archived":true,"fork":false,"pushed_at":"2024-02-29T09:25:41.000Z","size":3844,"stargazers_count":322,"open_issues_count":19,"forks_count":149,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-09-29T13:33:44.696Z","etag":null,"topics":["contributions-welcome","dungeon","game","gatsby","hacktoberfest","markdown-dungeon","material-ui","open-source","reactjs"],"latest_commit_sha":null,"homepage":"https://markdown-dungeon.netlify.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MakeContributions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-06-28T15:08:57.000Z","updated_at":"2024-09-11T08:20:52.000Z","dependencies_parsed_at":"2024-04-08T02:30:12.067Z","dependency_job_id":null,"html_url":"https://github.com/MakeContributions/markdown-dungeon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakeContributions%2Fmarkdown-dungeon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakeContributions%2Fmarkdown-dungeon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakeContributions%2Fmarkdown-dungeon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakeContributions%2Fmarkdown-dungeon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MakeContributions","download_url":"https://codeload.github.com/MakeContributions/markdown-dungeon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224337262,"owners_count":17294693,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contributions-welcome","dungeon","game","gatsby","hacktoberfest","markdown-dungeon","material-ui","open-source","reactjs"],"created_at":"2024-08-02T17:01:04.850Z","updated_at":"2024-11-12T19:30:21.304Z","avatar_url":"https://github.com/MakeContributions.png","language":"JavaScript","funding_links":[],"categories":["Those who are beginners, but feel they need something tricky..."],"sub_categories":[],"readme":"[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Open Source Helpers](https://www.codetriage.com/makecontributions/markdown-dungeon/badges/users.svg)](https://www.codetriage.com/makecontributions/markdown-dungeon)\n[![CodeQL](https://github.com/MakeContributions/markdown-dungeon/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/MakeContributions/markdown-dungeon/actions/workflows/codeql-analysis.yml)\n[![codespell](https://github.com/MakeContributions/markdown-dungeon/actions/workflows/codespell.yml/badge.svg)](https://github.com/MakeContributions/markdown-dungeon/actions/workflows/codespell.yml)\n[![Netlify Status](https://api.netlify.com/api/v1/badges/320e6533-33ab-402c-bfb9-ebac1881b260/deploy-status)](https://app.netlify.com/sites/markdown-dungeon/deploys)\n[![Discord](https://img.shields.io/discord/863049619734790185?color=7389D8\u0026logo=discord\u0026logoColor=ffffff\u0026label=\u0026labelColor=6A7EC2)](https://discord.gg/ydWxdqbTyK)\n\n\u003cdiv align=\"center\"\u003e\n    \u003ch1\u003e⚔️ Markdown Dungeon ⚔️\u003c/h1\u003e\n    \u003ci\u003eA dungeon is a place or prison where people are held. Usually, they can be found underground\u003c/i\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\nThis is an example repo illustration of a dungeon using **Markdown** on GitHub.\nIn the dungeon the reader chooses which option to take and jumps into an appropriate page of the room that is based on their choice.\nIt is collaborative because the room is written by many authors.\n\n| [Start a new game](./start-new-game.md) |\n| --------------------------------------- |\n\n## 📥 Installation\n\nYou need to install [yarn](https://www.npmjs.com/package/yarn).\n\n1. Clone the repo\n\n```bash\ngit clone https://github.com/MakeContributions/markdown-dungeon.git\n```\n\n2. Go to the folder\n\n```bash\ncd markdown-dungeon\n```\n\n3. Run install dependency\n\n```bash\nyarn\n```\n\n4. Create a `.env.development` file in the project root folder and copy the format of `.env.example` file.\n5. To start the development server run:\n\n```bash\nyarn start\n```\n\n\u003e Ensure you are not using PowerShell\n\n6. 🎉 Open your browser and go to http://localhost:8000/ or http://localhost:8000/___graphql\n\n## 👷‍♂️ Floor and the room format\n\nA **floor** is a folder and each floor is a collection of **rooms** and every room is a `Markdown` file.\nThe Markdown capability links are used for up/down and to go to another room, like the example below.\n\n[Go to Github dungeon](https://github.com/)\n\n```markdown\n[Go to Github dungeon](https://github.com/)\n```\n\n## 👩‍💻 Contribution Guidelines\n\n### 1. 📐 Make Adequately Sized Changes\n\n- Keep changes small\n- Don't add an option without adding any gate for readers who decide on that option,\n  so that the dungeon will not be full of dead links. Instead, the last markdown file the reader reaches on any path of the room should not have any options.\n\n#### Here are some examples of appropriate changes:\n\n- Add one or two sentences to an existing \"page\" (file) in the room.\n- Add a new option to an existing choice point, and link that option to an existing \"room\" or \"floor\".\n- 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\".\n- Add a couple of options to a current dead-end \"page\", and add a \"page\" or link to an existing \"page\" for each option.\n\n### 2. ⛩ Dungeon Structure\n\nStructure should be `dungeon-name/floor-number/room-number`, please see the definitions below for each variable:\n\n- dungeon-name: is a folder that contains floor number, should separate words with a dash(-), is alphanumeric. Example: **normal-dungeon-1**.\n- floor-number: is a folder that contains room number, is numeric do not add **0** before the number.\n\n```textile\n1, 2, 3 // Compliance\n\n01, 02, A3 // Non-Compliance\n```\n\n- 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.\n\n```textile\n1, 2, 3-AF, 3-01 // Compliance\n\n01A, 02*A3, A3+F // Non-Compliance\n```\n\n\u003e Folder or file name only accept all ASCII characters and the dash(-).\n\n\u003e If you created a new dungeon please add in [Start a new game](./start-new-game.md), add it on [images](./static/images) folder, and in the [dungeon-info.json](./src/data/dungeon-info.json), so the reader can go to your dungeon and open it on the website\n\n\u003e 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.\n\n### 3. 🔗 Use Relative Links\n\nThe links in this file must be [relative links](https://www.coffeecup.com/help/articles/absolute-vs-relative-pathslinks/) to continue working if the repository is forked.\n\n### 4. 📏 Line Lengths\n\nKeep 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.\n\n### 5. 🪓 Blank Lines Between Options\n\nInsert blank lines between the different options so that the options are visually separated.\n\n## 📝 License\n\n[MIT](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMakeContributions%2Fmarkdown-dungeon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMakeContributions%2Fmarkdown-dungeon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMakeContributions%2Fmarkdown-dungeon/lists"}