hashload / horse-doc

horse-mkdocs

This is a how-to document Horse based on mkdocs (Python)

Check out the pt-br readme version on leiame.md

To generate this documentation Python 3.6 (ou newer) is needed

If you does not have Python installed check it out on [Python Installation Tutorial] (Python.md)

Create an virtual environment (recommended) or just type pip install -r requirements.txt

Setup

1. Using virtual environment

To use a virtual env, first of all, install virtualenv lib by cmd pip install virtualenv Then generate the virtual env with following script.

#On Windows
>virtualenv venv
>"venv/Scripts/>activate.bat"

>(venv) pip install -r requirements.txt
>(venv) mkdocs serve -a localhost:8082

!!! This setup just allows you to work with one translation per time I did not solve thid translation feature at all, feel free to share if you have any suggestion.

It will show a tag (venv) on left side of the console, indicating that the virtual env is activated. At this point, the documentation server should be running on port 8082.

2. Without using virtual env

In this case, that's recommended to add the python into environmental variables The application will install all python packages into the same default folder that's python installed on

> py -m pip install -r requirements.txt
>mkdocs serve -a localhost:8082

How to build

Before you contribute acess owr [Conduct Guide] Any help is welcome: Creating a translation Solving issues Creating new pages with new topics Includding links and references to tutoriais and articles (no comercial content allowed) Reviewing the pages Repairing bugs or suggesting new approachs etc..

Take a look at oppened issues https://github.com/HashLoad/horse-doc/issues Check out the languages that was not translated yet

Improving contributions

Create clear examples
Format code as code [link]
Generate images PNG or Gifs [link]
Create diagrams with https://mermaid-js.github.io/mermaid/ [link]
Use advanced features of mk-docs [link]
See more. [link]

Issue guidelines

Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.

This file CONTRIBUTING.md provides a generic set of guidelines for developers to adapt and include in their own GitHub repositories, thereby taking advantage of GitHub's integration with contributing guidelines.

The section below can be included in your README to improve the visibility of your contribution guidelines.

If you think this guide can be improved, please let me know.

🐞 Bug reports 💡 Feature requests 🚀 Pull requests

Fork this project on https://github.com/HashLoad/horse-doc Give your contrubution and create a Pull Request for HashLoad/horse-doc

Todo list

[x] Checkout the Guidelines [ ] Write tutorials how to create documentation
[ ] a) Create diagrams with https://mermaid-js.github.io/mermaid/ [link]
[ ] b) Use advanced features of mk-docs [link]
[ ] c) Working with openned issues [link]

horse-doc's Issues

Usando middlewares

http://expressjs.com/pt-br/guide/using-middleware.html

Entregando arquivos estáticos

http://expressjs.com/pt-br/starter/static-files.html

Perguntas mais frequentes

http://expressjs.com/pt-br/starter/faq.html

Add social media links

Add social media links, based on mkdocs-material documentation
https://squidfunk.github.io/mkdocs-material/setup/setting-up-the-footer/#social-links

Manipulação de erros

http://expressjs.com/pt-br/guide/error-handling.html

Escrevendo middlewares

http://expressjs.com/pt-br/guide/writing-middleware.html

Documentação do Horse

(primeiramente desculpas, sei que o repositório está todo em Inglês, e estou escrevendo em Português)

Gostaria de parabenizar que esse projeto é fantástico, principalmente pela facilidade e simplicidade a que ele se propõe que me remete a algumas ferramentas em NodeJs que sinto falta em Delphi/Pascal, principalmente na área Web!

Agora, queria saber como eu poderia ajudar, não sou expert, mas tenho alguma experiência em Delphi, e nem que seja para criar uma documentação, uma home page. O que quero saber é, posso ajudá-los, e se sim, no quê?

Link the github repository into docs

Implements the topic "adding a git repository" of mkdocs-material tutorial
https://squidfunk.github.io/mkdocs-material/setup/adding-a-git-repository/