Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/giveth/giveth-wiki

Wiki for giveth.io
https://github.com/giveth/giveth-wiki

Last synced: 8 days ago
JSON representation

Wiki for giveth.io

Awesome Lists containing this project

README

        

# Giveth Wiki
The wiki for the Giveth DApp, the Giveth DAC and everything else included in the Giveth Galaxy. A place to get into detail about concepts, explanations and guides./customize parts of the wiki, please refer to: [http://www.mkdocs.org/](http://www.mkdocs.org/)

## About
The wiki is accessible via this link: https://wiki.giveth.io

It is built with https://netlify.com using the static site generator mkdocs http://www.mkdocs.org/

## Contributing
**Contributing content is very easy!** Just edit the files contained in the wiki directory.

**Please note:** If you are a **first time contributor to the Wiki**, please talk to us on Riot first to get you started (#giveth-contributors)

For an introduction to markdown, see: https://guides.github.com/features/mastering-markdown/

You can edit the files either directly on GitHub, or clone the project and push changes to a separate branch. It is possible to preview your changes directly in your pull request via netlify's preview build option.

## Installation
Requires MKdocs and Material theme to test locally. [http://www.mkdocs.org/](http://www.mkdocs.org/). [https://squidfunk.github.io/mkdocs-material/](https://squidfunk.github.io/mkdocs-material/)

Usually the steps to be followed come down to:
1. Install Python (and set the PATH environment variable)
[https://www.python.org/](https://www.python.org/)
2. Install Mkdocs
``pip install mkdocs``
3. Install Material Theme
``pip install mkdocs-material``

## User Guide
See a detailed guide here: [http://www.mkdocs.org/user-guide/writing-your-docs/](http://www.mkdocs.org/user-guide/writing-your-docs/)

**Please Note:** Before considering a new page, pls look at the Wiki structure and see if it fits as an addendum to an existing article or consider if your content may be suited for the **FAQ**, or the **glossary**

### To add a new page:
1 - Create a new markdown file (.md) in a subfolder of /wiki/

2 - Add a new entry that points to your newly created file under the **nav-section** in *mkdocs.yml*

### To add a new category:
1 - Create a subfolder in /wiki/

2 - Add a new entry that points to your newly created folder under the **nav-section** in *mkdocs.yml*

### Visual Identity:
If you consider implementing some graphics, pls refer to the visual identity page for info on typefaces, colors, and the asset repository here: [https://wiki.giveth.io/documentation/visual-identity/](https://wiki.giveth.io/documentation/visual-identity/)

### Images:
To add an image first upload it to /images/subfolder/, then insert a link to the file in your document:

```![ImageName](image/subfolder/imagefile.png)```

### Shields

Please create shields from https://shields.io/