frankgmail / docs

Web App Generator - Official Documentation | AppSeed

Home Page:https://docs.appseed.us

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AppSeed Docs

The official documentation repo for all web apps and boilerplate code


How to build the docs

The project uses Mkdocs to generate the HTML pages from Markdown files. To build locally the project, Nodejs must be installed.

$ # Clone Sources
$ git clone https://github.com/app-generator/docs.git
$ cd docs
$
$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .\env\Scripts\activate
$
$ # Install requirements (mkdoks & related extensions)
$ pip3 install -r requirements.txt
$
$ # Install modules
$ yarn
$
$ # Start the app
$ yarn start
$
$ # Please visit http://localhost:8000 in browser

How to contribute

Each page provides Edit on github shortcut button in the top bar (see below). By clicking on it, the user is redirected to Github and invited to fork, edit the page and make a pull request to notify the owner that the content is updated.

AppSeed Docs - Edit on Github Option.

The pull request triggered by the change will be merged in the documentation after validation.

For more information please contact the Support team on Discord server.


Latest Products


Latest Content Items


Latest update - Mkdocs core

Support include of markdown files

Help Snippet - Extracted from Mkdocs Github repository

# File: mkdocs.yml

markdown_extensions:
    - markdown_include.include:
        base_path: docs

Usage

# File: Markdown File Sample

{!some/dir/in/docs/filename.md!}


AppSeed Docs - Provided by the AppSeed

About

Web App Generator - Official Documentation | AppSeed

https://docs.appseed.us