# nebdocs

**Repository Path**: artsitecc/nebdocs

## Basic Information

- **Project Name**: nebdocs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-01-31
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Other versions: [[zh-CN](https://github.com/nebulasio/nebdocs/tree/zh-CN)] [[pt-PT](https://github.com/nebulasio/nebdocs/tree/pt-PT)] [[es-ES](https://github.com/nebulasio/nebdocs/tree/es)] [[ko-KR](https://github.com/nebulasio/nebdocs/tree/ko-KR)]

# Welcome to the open-source Nebulas Wiki!

Nebulas community is open and everyone can be a contributor and build a decentralized world with us.

The Nebulas wiki is a collaboration tool for the community to publish various documents in a collaborative manner. Include using guides, developing guides, learning resources, and other useful documents. 

The mainnet development part of this Nebulas Wiki was based on ["the wiki."](https://github.com/nebulasio/wiki) 


# How to Contribute

Nebulas aims for a continuously improving ecosystem, which means we need help from the community. We need your contributions! It is not limited exclusively to programming, but also bug reports and translations, spreading the tenets of Nebulas, answering questions, and so on.

[Learn more about how to contribute](https://wiki.nebulas.io/en/latest/how-to-contribute.html)

# Get Started

This project was created by [sphinx](http://www.sphinx-doc.org/en/master/) and uploaded to [readthedocs](https://readthedocs.org/) for hosting. Url of online documentation after hosting is: [https://nebdocs.readthedocs.io/en/latest/](https://nebdocs.readthedocs.io/en/latest/).

This project supports documents in the following two formats:

- Markdown(.md)
- reStructuredText(.rst)

The directory structure of the document is defined in the README.rst file in the same directory.

## Language version and branch rules:
1. The multi-language version is managed separately by different branches. The currently supported languages are as follows:
- master: English version;
- zh-CN: Simplified Chinese version;
- pt-PT: Portuguese version;
- es-ES: Spanish version;
- ko-KR: Korean version (very incomplete, pull requests welcome).
2. To facilitate document management, the document structure of different branches is as consistent as possible with the main branch;
3. Each language is allowed to have its own temporary version. It is recommended to add the suffix version number to the version name, for example, en1.0, zh-CN1.1;

## How to build
1. clone the project from github, next command refers to the master branch:

```bash
git clone https://github.com/nebulasio/nebdocs.git
```

2. install the necessary python components:

```bash
pip install sphinx==1.5.6 sphinx-autobuild sphinx_rtd_theme recommonmark
```
**Note:** installing sphinx via pip is unreliable. Use your distribution's package manager if possible.

3. build the project:

```bash
cd nebdocs
make html
```

## How to add a new document
### If you need to add a file
1. Add the file to the appropriate directory;
2. Locate the README.rst file in the directory where the file is located (the project root directory is index.rst file), open the file, and add the newly added file name to the file list after the 'toctree' keyword. E.g:

For this file structure:
```
+--folder
   |
   +--README.rst
   +--config.md
   +--contributors.md
   +--newFile.md
```

The content of README.rst should look like this:
```
.. toctree::
    :titlesonly:

    Config.md
    Contributors.md
    newFile.md
```

### If you need to add a new directory
In this case, you need to add a README.rst file to define the document directory structure in this directory. Put other file names in the file list after the 'toctree' keyword. For details, refer to other README.rst files. The file list in the README.rst file of the previous directory should add the relative path of the README.rst file of the current directory, for example:

For this file structure:
```
+--folder
   |
   +--README.rst
   +--config.md
   +--contributors.md
   +--newDirectory
      |
      +--README.rst
      +--newFile.md
```
The contents of the folder/README.rst file should be:
```
.. toctree::
    :titlesonly:

    Config.md
    Contributors.md
    newDirectory/README.rst
```

## How to add a new language version

1. Create a new branch, for the chinese version, for instance:
```bash
Git checkout -b zh-CN
```
2. Modify the github configuration in ./docs/conf.py, find the 'html_context' definition, and change the value of the 'github_version' field to the new branch name 'zh-CN', as follows:

```python
# VCS options:
Html_context = {
     "display_github": True, # Integrate GitHub
     "github_user": "nebulasio", # Username
     "github_repo": "nebdocs", # Repo name
     "github_version": "zh-CN", # Version
     "conf_py_path": "/", # Path in the checkout to the docs root
}
```

3. Replace the documents that you need to translate with the new language version.

4. Submit the files to github:

```bash
Git push --set-upstream zh-CN
```

**Note:** it is highly likely you will need to rebase master onto that branch in order for the team to be able to merge the pull request cleanly. To do so, and avoid all the conflicts that will certainly come with it, do as follows, from your working branch, after having updated master with ```git pull origin master```:
```bash
git rebase -Xtheirs master
git push -f
```

5. Notify the manager to add a new language version to the readthedocs' online documentation.