How to edit WIKI

Robonomics WIKI is open source. Any corrections are welcome: fixing errors, typos, some unclear or outdated information, translation into any language. You'll need a GitHub account.

Edit existing doc

  1. Choose page
  2. Click button "Edit page" marked with the Github logo on the page you want to edit
  3. Clicking on the button will take you to the .md file.
  4. Please, follow common rules for editing Markdown files, bearing in mind a few features of the WIKI stack:

Frontmatter

Docs in Robonomics WIKI contain frontmatter block. It must be at the top of the Markdown file, and must take the form of valid YAML set between triple-dashed lines. Between the triple-dashed lines, you can set or edit folowing options:

---
title: How to contribute # Title for the page, you do not need to duplicate it in text
contributors: [positivecrash] # Main contributors (who actively curates this page). GitHub nickname required, without any additional symbols
translated: true # "true" if it has been translated in current language (see locale folder name of doc)
---

Images

  1. Upload image in folder /docs/images/url-of-your-doc
  • If image needs to be localized, insert all of them in one folder
  • Use locale appendix in name of images if it's localized, e.g. image_en.jpg
  • Make sure your image is web optimised and at the same time it looks good
  1. Insert images standart way for Markdown files.

YouTube videos

You can embed any YouTube video in doc by inserting share link as separate paragraph without any additional quotes or tags, e.g.: https://youtu.be/kQaSwNYHJQ8

Asciinema

Robonomics WIKI has support for Asciinema. To insert Asciinema, please, follow these instructions:

  • Import component after frontmatter block import Asciinema from '~/components/Asciinema.vue'
  • Insert as separate paragraph <Asciinema vid="WCFcx8C6M8e52UKDNei1xZloU"/>, where is vid is ID of specific asciicast

You can get the widget script for a specific asciicast by clicking on β€œEmbed” link on asciicast page. It looks like this: <script src="https://asciinema.org/a/14.js" id="asciicast-14" async></script>Asciinema docs

In the example above vid is 14.

Add new doc

If you need to add new page in docs of Robonomics WIKI, please, follow these steps:

  1. Find the folder with the locale that matches the language of the article you are adding, e.g. /docs/en/
  2. Create .md file, using in name latin characters and follow common rules for url structure
  3. Edit file as described above
  4. Duplicate file to other locale folders, even if you do not plan to translate them. Do not forget mark in frontmatter not translated pages as translated: false
  5. Add doc in menu:
  • Open file /data/sidebar_docs.yaml
  • Decide where to place your doc
  • If you want to create new section, provide title with locale appendix, using only locales your section is translated
  • Add doc with link. The link must be only one, and must not contain locale characters. Correct is /docs/url-of-your-doc, not correct is /docs/en/url-of-your-doc
  • Use valid YAML for /data/sidebar_docs.yaml and rely on the existing file structure

Submit Pull Request

Make pull request for any content you changed including typos, translations, outdated information or broken links.

Decisions about individual PRs made by Robonomics core team. Special grants in XRT are also possible for extended contribution πŸ€–πŸ’™πŸ’›πŸ’šπŸ’ŽπŸ­πŸŽ‰πŸ”Œ

← How to contribute Help us translate β†’