Skip to content

Commit

Permalink
Add MK Documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
JohnGrubba committed Jun 24, 2024
1 parent c6d7263 commit c4ea263
Show file tree
Hide file tree
Showing 6 changed files with 94 additions and 11 deletions.
23 changes: 23 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
name: ci
on:
push:
branches:
- master
- main
permissions:
contents: write
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-python@v4
with:
python-version: 3.x
- uses: actions/cache@v2
with:
key: ${{ github.ref }}
path: .cache
- run: pip install mkdocs-material
- run: pip install pillow cairosvg
- run: mkdocs gh-deploy --force
19 changes: 8 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,12 @@
# EZAuth
<img src="assets/ezauth_banner.png" />

- Fully Customizable Authentication Service
- Built on top of FastAPI and MongoDB
<h3 align="center">High performance self-hosted and fully customizable authentication service</h3>

## Inbuilt E-Mail Templates
## Disclaimer

### 1. Email Verification
- Can be enabled in the `config.json` file.
- Check <a href="./email/ConfirmEmail.md">here</a> for predefined placeholders.
- ⚠️ The project is under **very active** development.
- ⚠️ Expect bugs and breaking changes.
- ⚠️ Make sure to always have a backup of your user data.

### 2. Welcome Email
- Can be enabled in the `config.json` file.
- Will be sent out after the user has successfully verified their email address.
- Check <a href="./email/WelcomeMail.md">here</a> for predefined placeholders.
> [!NOTE]
> The Documentation is still in progress.
1 change: 1 addition & 0 deletions docs/email.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# EMAIL Configuration
Binary file added docs/ezauth_banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
17 changes: 17 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Welcome to MkDocs

For full documentation visit [mkdocs.org](https://www.mkdocs.org).

## Commands

* `mkdocs new [dir-name]` - Create a new project.
* `mkdocs serve` - Start the live-reloading docs server.
* `mkdocs build` - Build the documentation site.
* `mkdocs -h` - Print help message and exit.

## Project layout

mkdocs.yml # The configuration file.
docs/
index.md # The documentation homepage.
... # Other markdown pages, images and other files.
45 changes: 45 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
site_name: EZAuth
site_description: EZAuth is a high performance self-hosted and fully customizable authentication service
use_directory_urls: True
repo_url: https://github.com/JohnGrubba/ezauth
nav:
- Home: index.md
- Quickstart with Docker: docker_quickstart.md
- Installation:
- Linux/MacOS/Raspberry: installation.md
- Windows: windows_installation.md
- Freqtrade Basics: bot-basics.md
- Configuration: configuration.md
- Strategy Customization: strategy-customization.md
- Strategy Callbacks: strategy-callbacks.md
- Stoploss: stoploss.md
- Plugins: plugins.md
- Start the bot: bot-usage.md
- Control the bot:
- Telegram: telegram-usage.md
- freqUI: freq-ui.md
- REST API: rest-api.md
- Web Hook: webhook-config.md
theme:
name: material
logo: "ezauth_banner.png"
features:
- content.code.annotate
- search.share
- content.code.copy
- navigation.top
- navigation.footer
language: en
palette:
- scheme: default
primary: "blue grey"
accent: "tear"
toggle:
icon: material/toggle-switch-off-outline
name: Switch to dark mode
- scheme: slate
primary: "blue grey"
accent: "tear"
toggle:
icon: material/toggle-switch
name: Switch to light mode

0 comments on commit c4ea263

Please sign in to comment.