DOC: Moving away from restructured text about pyfunceble HOT 8 OPEN

• #265 should be fixed.
• #329 should be fixed.

from pyfunceble.

Why not just use the gh wiki?? it is the same structure and you only need to transform month of my works once!

from pyfunceble.

It's also a syntax conversion a lot of things won't change.

I also want the documentation to be a bit more "modern" looking. Right now, we can't embed any example asciinema videos ... 😞

See by yourself how it looks now:

git checkout switch-to-mkdocs
# activate environemt
virtualenv -p python3 venv
. venv/bin/activate
pip install -e .[full]
# Serve documentation locally.
mkdocs serve
# Open Documentation with browser.
palemoon http://127.0.0.1:8000

from pyfunceble.

Not spend a lot on this one, but ran into this error

mkdocs serve
Error: MkDocs encountered an error parsing the configuration file: while constructing a Python object
cannot find module 'material.extensions.emoji' (No module named 'material.extensions')
in "$SOME_PATH/funilrys/pyfunceble/mkdocs.yml", line 48, column 20

from pyfunceble.

Nice catch. I really need to start testing everything inside a container ...

from pyfunceble.

Patch is on its way.

from pyfunceble.

A short first hand impression... 😒 The white background is a killer. I would also recommend using a background color in the banner of the same green as your logo.

Browsing structure... not worse, but images are not loaded as you might have expected

These are only first hand impression, and I will spend some time reviewing the code in competition of JetBrains witerside, Yet another markdown tool that allows you to do a lot of cool stuff(config) and controlling the behavior. (Free tool), this again in competition to the YouTrack(paid version, but no diff to free version) knowledge base, which includes a issue board that can interact with Github/Gitlab issues. And a helpdesk Requires login, but the submitform is HTML based and is designed to be included in any other html based page.

The preview should be available at https://kb.mypdns.org/articles/PF-A-1/PyFunceble (Once the accessibility have been solved by JetBrains support)

from pyfunceble.

@funilrys You can download https://github.com/spirillen/PyFunceble/tree/spirillen-writerside-v.0.1a and have a preview for the docs written with the writerside tool, the page I have been playing the most with is lookup.html where you can see examples of features I'm not aware of should be available to mkdocs.

Next I will fill the gh wiki for comparison https://github.com/spirillen/PyFunceble/wiki

Please let me know what you choose as I might be open for helping transferring the docs into new format

UPDATE: Dropped the WIKI, it just sucks...

from pyfunceble.