Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wordops/docs.wordops.net
WordOps documentation built with Mkdocs
https://github.com/wordops/docs.wordops.net
documentation tutorial wiki wordops wordops-documentation
Last synced: 5 days ago
JSON representation
WordOps documentation built with Mkdocs
- Host: GitHub
- URL: https://github.com/wordops/docs.wordops.net
- Owner: WordOps
- License: mit
- Created: 2019-03-22T06:44:04.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-06-16T21:56:57.000Z (5 months ago)
- Last Synced: 2024-06-16T22:49:02.377Z (5 months ago)
- Topics: documentation, tutorial, wiki, wordops, wordops-documentation
- Homepage: https://docs.wordops.net
- Size: 20.3 MB
- Stars: 9
- Watchers: 10
- Forks: 38
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Security: docs/security/recommendations.md
Awesome Lists containing this project
README
# WordOps Documentation
WordOps documentation sources files are stored in this repository.
## Contributing
Anyone can contribute and improve WordOps documentation. Pull requests are warmly welcome.
You can either edit page content from Github or fork the repository before cloning it on your computer to work with the text editor of your choice.
If you have any question about this documentation, feel free to join us on [Slack](https://community.wordops.io/slack) or to ask your question on [WordOps Community forum](https://community.wordops.net/)
### Method 1: Edit page content directly from Github
![edit](https://img.virtubox.net/images/2019/03/29/image.png)
1. Browse the documentation and use the edit button available on the top right to open the file with Github editor
2. Edit content directly from Github by browsing the folder docs and by using the button "edit this file" available on the right.
3. Github will automatically fork the repository (copy the repository in your account)
4. After you finished making changes, you will be able to commit changes (saving changes with a message which describe what was added/changed/removed).
5. The last step to apply changes on this repository is to open a PR(pull request). We will review the commits you made and if everything is okay, we will merge the PR.### Method 2: Work on the documentation locally
If you want to work on WordOps documentation on your computer, you just have to:
1. Fork the repository using the button "Fork" available on the top right of this page
2. clone the forked repository:- with the CLI: `git clone https://github.com/YourUsername/docs.wordops.net.git`
- or using [Github Desktop App](https://desktop.github.com/)3. create/edit markdown files
4. commit your modification `git add . && git commit -am "your commit message"`
5. push your modification `git push`
6. open a pull request### Documentation structure
Documentation source files are stored inside `docs` directory.
Here the current structure:```bash
├── commands # commands folder
│ ├── clean.md
│ ├── debug.md
│ ├── info.md
│ ├── log.md
│ ├── maintenance.md
│ ├── secure.md
│ ├── site.md
│ ├── stack.md
│ └── update.md
├── commands.md # Page -> commands Overview
├── getting-started
│ ├── creating-sites.md
│ ├── installation-guide.md
│ ├── post-install-steps.md
│ └── prerequesites.md
├── guides # guides folder ( add your extented guides & tutorials inside)
│ └── migration-from-easyengine.md
├── guides.md # Page -> Guides Overview
├── how-to # how to folder (add your short tutorial inside)
│ └── wp-language.md
├── how-to.md # Page -> How to Overview
```Each part of the documentation is stored in a separated folder. `how-to` is the folder used for any short tutorial or explanation about WordOps usage. `guides` is the folder used for any extended guide or tutorial about WordOps.
Example:
> I want to write a tutorial to explain how to use WordOps with a remote MySQL server.
Create the file remote-mysql-server.md in the folder `how-to`.
### Working with mkdocs
WordOps documentation is built with [mkdocs](https://github.com/mkdocs/mkdocs) and [mkdocs-material](https://github.com/squidfunk/mkdocs-material).
Mkdocs provide the ability to build a static documentation site, with source files written in Markdown, and configured with a single YAML configuration file.
MkDocs builds completely static HTML sites that you can host on GitHub page or anywhere else.You can install Mkdocs locally to use the site live preview feature.
- install mkdocs:
- [guide for windows](https://gist.github.com/VirtuBox/2f149ce45e2449c36f18cb634243fe90)
- `apt install mkdocs -y` on debian/ubuntu
- start mkdocs built-in web-server `mkdocs serve` or `mkdocs.exe serve` inside the repository folder
- browse documentation live preview on http://127.0.0.1:8000You can learn more about mkdocs usage on the [official documentation](https://www.mkdocs.org/user-guide/writing-your-docs/)