aa-simplewiki


Nameaa-simplewiki JSON
Version 2.1.0 PyPI version JSON
download
home_pagehttps://github.com/meowosaurus/aa-simplewiki
SummaryAlliance Auth Wiki Plugin
upload_time2024-09-17 22:47:17
maintainerMeowosaurus
docs_urlNone
authorMeowosaurus
requires_python~=3.8
licenseGNU General Public License v3 (GPLv3)
keywords allianceauth simplewiki
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # SimpleWiki
A simple wiki plugin for alliance auth. It supports multiple pages with different sections. Every page and every section can have their own icon. Written in Python with Django.

# Contents
- [SimpleWiki](#simplewiki)
- [Contents](#contents)
- [Current Features](#current-features)
  - [TODO:](#todo)
  - [Planned](#planned)
    - [Active devs:](#active-devs)
  - [Screenshots](#screenshots)
    - [Admin Panel](#admin-panel)
  - [Installation](#installation)
    - [Alliance Auth Production](#alliance-auth-production)
      - [Non-Docker Version](#non-docker-version)
      - [Docker Version](#docker-version)
    - [Alliance Auth Development](#alliance-auth-development)
  - [Usage](#usage)
  - [Permissions](#permissions)
  - [Commands](#commands)
  - [Dependencies](#dependencies)
  - [Support](#support)

# Current Features
* Create custom wiki menus with dropdowns plus different sections on each menu
* Add an icon next to menus or sections
* Edit pages on the admin panel with a WYSIWYG editor
  * Support for different header sizes.
  * Support for bold, italic, underline and strikethrough text.
  * Support for aligning text to the left, center or right.
  * Support for ordered and unordered lists.
  * Add links, remove links, add horizontal lines, add quotes and spoilers.
  * Add images (url only), add videos (YouTube only) and tables.
  * Add alerts and Google Drive folders.
  * Remove formatting.
* Search function: Search across all wiki menus and sections
* Permission system:
  * Editor permissions can be added to single users or groups via the admin panel
  * Alliance Auth groups are synced to simplewiki: Certain pages can only be seen by a specific group
  * Multiple groups support: As long as the user is in any of the required groups, they can access the menu
* Editor interface
  * Users with editor permission can create, edit and delete custom menus and sections (editor_access)
  * Users with editor permission see edit and delete buttons above all sections (editor_access)
  * Change menu position's with a drag and drop system

## TODO:
* Quality-of-life updates
* Implement better logging
* Improve code documentation

## Planned
* Add translations for 
  * German
  * Spanish
  * Chinese
  * Russian
  * Korean 
  * French
  * Italian

### Active devs:
* [Meowosaurus](https://github.com/meowosaurus)

## Screenshots
![Showcase](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/main.png)

### Admin Panel
![Menu Admin](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/menu_admin.png)

![Menu Edit](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/section_admin.png)

![Menu Sorting](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/layout_admin.gif)

## Installation

### Alliance Auth Production

#### Non-Docker Version
1.) Install the pip package via `pip install aa-simplewiki`

2.) Add `simplewiki` to your `INSTALLED_APPS` in your projects `local.py`

3.) Restart your server, then run migrations and collectstatic

#### Docker Version
1.) Please make sure you followed the custom docker-image tutorial [here](https://gitlab.com/allianceauth/allianceauth/-/tree/master/docker#using-a-custom-docker-image): 

2.) Edit your `conf/requirements` and add the following line `aa-simplewiki` (Check https://pypi.org/project/aa-simplewiki/ for different versions!)

3.) Add `simplewiki` to your `INSTALLED_APPS` in your projects `local.py`

4.) Start your server `docker compose --env-file=.env up -d`

5.) Run `docker compose exec allianceauth bash`

7.) Run `auth migrate`

8.) Run `auth collectstatic`

### Alliance Auth Development 
Make sure you have installed alliance auth in the correct way: https://allianceauth.readthedocs.io/en/latest/development/dev_setup/index.html

1.) Download the repo `git clone https://github.com/meowosaurus/aa-simplewiki`

2.) Make sure it's under the root folder `aa-dev`, not under `myauth` 

3.) Change directory into `aa-dev` aand run `pip install -e aa-simplewiki`

**Important**: If you are getting an error saying that `simplewiki` is not installed after running `pip install -e aa-simplewiki`, delete the `setup.py` file in the aa-simplewiki root directory and try again.

4.) Add `simplewiki` to your `INSTALLED_APPS` in your projects `local.py`

5.) Change directory into `myauth`

6.) Make migrations with `python manage.py makemigrations`

7.) Migrate with `python manage.py migrate`

8.) Restart auth with `python manage.py runserver`

## Usage
Check out our wiki on GitHub: https://github.com/meowosaurus/aa-simplewiki/wiki

1.) Go to `{your_auth_url}/admin` -> SimpleWiki -> Add Menu Item

2.) Give it a title, an index (menu items are sorted by their index from low to high) and a name (the name is the name in the url) and hit save.

3.) Go to `{your_auth_url}/admin` -> SimpleWiki -> Add Page Item

4.) Give it a title, a menu page (this is the menu page it will be under), an index (ordered from low to high) and a content description. This description will be the main content and you can use HTML. Hit save.

5.) Go back to your main auth page, go under Wiki and you've created your first menu and page.

## Permissions
Perm | Admin Site | Auth Site 
 --- | --- | --- 
basic_access | None | Can view all wiki pages
editor_access | None | Can create, edit and delete wiki pages and menus

## Commands
- Migrate all data from 1.0.x to 1.1.1 to use new model system: `python manage.py simplewiki_migrate_v1_1`
- Migrate section data from 1.1.1 and later to 1.1.3 to add author details: `python manage.py simplewiki_migrate_v1_3`

## Dependencies
- [Alliance Auth](https://gitlab.com/allianceauth/allianceauth)
- [allianceauth-app-utils](https://gitlab.com/ErikKalkoken/allianceauth-app-utils)
- [Mistune](https://github.com/lepture/mistune)
- [jQuery](https://github.com/jquery/jquery)
- [Nestable](https://github.com/dbushell/Nestable)

## Support
* On Discord: meowlicious

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/meowosaurus/aa-simplewiki",
    "name": "aa-simplewiki",
    "maintainer": "Meowosaurus",
    "docs_url": null,
    "requires_python": "~=3.8",
    "maintainer_email": "info@bjsonnen.de",
    "keywords": "allianceauth, simplewiki",
    "author": "Meowosaurus",
    "author_email": "info@bjsonnen.de",
    "download_url": "https://files.pythonhosted.org/packages/4d/8d/693dc1fd9eddfd6e9aa421cba6ab17ec262bd2a17b5124fa17df7101135d/aa_simplewiki-2.1.0.tar.gz",
    "platform": null,
    "description": "# SimpleWiki\nA simple wiki plugin for alliance auth. It supports multiple pages with different sections. Every page and every section can have their own icon. Written in Python with Django.\n\n# Contents\n- [SimpleWiki](#simplewiki)\n- [Contents](#contents)\n- [Current Features](#current-features)\n  - [TODO:](#todo)\n  - [Planned](#planned)\n    - [Active devs:](#active-devs)\n  - [Screenshots](#screenshots)\n    - [Admin Panel](#admin-panel)\n  - [Installation](#installation)\n    - [Alliance Auth Production](#alliance-auth-production)\n      - [Non-Docker Version](#non-docker-version)\n      - [Docker Version](#docker-version)\n    - [Alliance Auth Development](#alliance-auth-development)\n  - [Usage](#usage)\n  - [Permissions](#permissions)\n  - [Commands](#commands)\n  - [Dependencies](#dependencies)\n  - [Support](#support)\n\n# Current Features\n* Create custom wiki menus with dropdowns plus different sections on each menu\n* Add an icon next to menus or sections\n* Edit pages on the admin panel with a WYSIWYG editor\n  * Support for different header sizes.\n  * Support for bold, italic, underline and strikethrough text.\n  * Support for aligning text to the left, center or right.\n  * Support for ordered and unordered lists.\n  * Add links, remove links, add horizontal lines, add quotes and spoilers.\n  * Add images (url only), add videos (YouTube only) and tables.\n  * Add alerts and Google Drive folders.\n  * Remove formatting.\n* Search function: Search across all wiki menus and sections\n* Permission system:\n  * Editor permissions can be added to single users or groups via the admin panel\n  * Alliance Auth groups are synced to simplewiki: Certain pages can only be seen by a specific group\n  * Multiple groups support: As long as the user is in any of the required groups, they can access the menu\n* Editor interface\n  * Users with editor permission can create, edit and delete custom menus and sections (editor_access)\n  * Users with editor permission see edit and delete buttons above all sections (editor_access)\n  * Change menu position's with a drag and drop system\n\n## TODO:\n* Quality-of-life updates\n* Implement better logging\n* Improve code documentation\n\n## Planned\n* Add translations for \n  * German\n  * Spanish\n  * Chinese\n  * Russian\n  * Korean \n  * French\n  * Italian\n\n### Active devs:\n* [Meowosaurus](https://github.com/meowosaurus)\n\n## Screenshots\n![Showcase](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/main.png)\n\n### Admin Panel\n![Menu Admin](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/menu_admin.png)\n\n![Menu Edit](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/section_admin.png)\n\n![Menu Sorting](https://github.com/meowosaurus/aa-simplewiki/blob/master/images/layout_admin.gif)\n\n## Installation\n\n### Alliance Auth Production\n\n#### Non-Docker Version\n1.) Install the pip package via `pip install aa-simplewiki`\n\n2.) Add `simplewiki` to your `INSTALLED_APPS` in your projects `local.py`\n\n3.) Restart your server, then run migrations and collectstatic\n\n#### Docker Version\n1.) Please make sure you followed the custom docker-image tutorial [here](https://gitlab.com/allianceauth/allianceauth/-/tree/master/docker#using-a-custom-docker-image): \n\n2.) Edit your `conf/requirements` and add the following line `aa-simplewiki` (Check https://pypi.org/project/aa-simplewiki/ for different versions!)\n\n3.) Add `simplewiki` to your `INSTALLED_APPS` in your projects `local.py`\n\n4.) Start your server `docker compose --env-file=.env up -d`\n\n5.) Run `docker compose exec allianceauth bash`\n\n7.) Run `auth migrate`\n\n8.) Run `auth collectstatic`\n\n### Alliance Auth Development \nMake sure you have installed alliance auth in the correct way: https://allianceauth.readthedocs.io/en/latest/development/dev_setup/index.html\n\n1.) Download the repo `git clone https://github.com/meowosaurus/aa-simplewiki`\n\n2.) Make sure it's under the root folder `aa-dev`, not under `myauth` \n\n3.) Change directory into `aa-dev` aand run `pip install -e aa-simplewiki`\n\n**Important**: If you are getting an error saying that `simplewiki` is not installed after running `pip install -e aa-simplewiki`, delete the `setup.py` file in the aa-simplewiki root directory and try again.\n\n4.) Add `simplewiki` to your `INSTALLED_APPS` in your projects `local.py`\n\n5.) Change directory into `myauth`\n\n6.) Make migrations with `python manage.py makemigrations`\n\n7.) Migrate with `python manage.py migrate`\n\n8.) Restart auth with `python manage.py runserver`\n\n## Usage\nCheck out our wiki on GitHub: https://github.com/meowosaurus/aa-simplewiki/wiki\n\n1.) Go to `{your_auth_url}/admin` -> SimpleWiki -> Add Menu Item\n\n2.) Give it a title, an index (menu items are sorted by their index from low to high) and a name (the name is the name in the url) and hit save.\n\n3.) Go to `{your_auth_url}/admin` -> SimpleWiki -> Add Page Item\n\n4.) Give it a title, a menu page (this is the menu page it will be under), an index (ordered from low to high) and a content description. This description will be the main content and you can use HTML. Hit save.\n\n5.) Go back to your main auth page, go under Wiki and you've created your first menu and page.\n\n## Permissions\nPerm | Admin Site | Auth Site \n --- | --- | --- \nbasic_access | None | Can view all wiki pages\neditor_access | None | Can create, edit and delete wiki pages and menus\n\n## Commands\n- Migrate all data from 1.0.x to 1.1.1 to use new model system: `python manage.py simplewiki_migrate_v1_1`\n- Migrate section data from 1.1.1 and later to 1.1.3 to add author details: `python manage.py simplewiki_migrate_v1_3`\n\n## Dependencies\n- [Alliance Auth](https://gitlab.com/allianceauth/allianceauth)\n- [allianceauth-app-utils](https://gitlab.com/ErikKalkoken/allianceauth-app-utils)\n- [Mistune](https://github.com/lepture/mistune)\n- [jQuery](https://github.com/jquery/jquery)\n- [Nestable](https://github.com/dbushell/Nestable)\n\n## Support\n* On Discord: meowlicious\n",
    "bugtrack_url": null,
    "license": "GNU General Public License v3 (GPLv3)",
    "summary": "Alliance Auth Wiki Plugin",
    "version": "2.1.0",
    "project_urls": {
        "Changelog": "https://github.com/meowosaurus/aa-simplewiki/blob/master/CHANGELOG.md",
        "Homepage": "https://github.com/meowosaurus/aa-simplewiki",
        "Issue / Bug Reports": "https://github.com/meowosaurus/aa-simplewiki/issues"
    },
    "split_keywords": [
        "allianceauth",
        " simplewiki"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7385d9c63beca0e10c9f6aa8a13d6face86a5513ab5c5f55ba59a160d3f8c21f",
                "md5": "bb644bae0a8506a4e7222379cce123a0",
                "sha256": "ccccd8bd360e8084f9bb3f8b220cac687c1072054b10aeae3ee27c80fa9c7cd3"
            },
            "downloads": -1,
            "filename": "aa_simplewiki-2.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bb644bae0a8506a4e7222379cce123a0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "~=3.8",
            "size": 138401,
            "upload_time": "2024-09-17T22:47:15",
            "upload_time_iso_8601": "2024-09-17T22:47:15.589636Z",
            "url": "https://files.pythonhosted.org/packages/73/85/d9c63beca0e10c9f6aa8a13d6face86a5513ab5c5f55ba59a160d3f8c21f/aa_simplewiki-2.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4d8d693dc1fd9eddfd6e9aa421cba6ab17ec262bd2a17b5124fa17df7101135d",
                "md5": "63db45d31e9df701726d24b471c5afd4",
                "sha256": "34b7f03af817e1ac1801bea63e5658764d3e6a331da8b7b56d0d23bbbc3a1710"
            },
            "downloads": -1,
            "filename": "aa_simplewiki-2.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "63db45d31e9df701726d24b471c5afd4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "~=3.8",
            "size": 106564,
            "upload_time": "2024-09-17T22:47:17",
            "upload_time_iso_8601": "2024-09-17T22:47:17.716532Z",
            "url": "https://files.pythonhosted.org/packages/4d/8d/693dc1fd9eddfd6e9aa421cba6ab17ec262bd2a17b5124fa17df7101135d/aa_simplewiki-2.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-17 22:47:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "meowosaurus",
    "github_project": "aa-simplewiki",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "tox": true,
    "lcname": "aa-simplewiki"
}
        
Elapsed time: 0.34382s