Add doc pages
Added docs with sphinx as mentiined in https://github.com/rinigus/pure-maps/issues/400.
Before merging, you can preview here.
Will add more from time to time, thought its better to 'release early' and 'release often'.
Hope to get some constructive feedback as well as maybe a screenshot if it looks weird on a big screen. All made on a linux mobile phone and it displays nice here.
-
yes, it can be build with github ci files, i have to look into this, but it should be more or less something like this
-
it builds on all platforms, i wrote and built it on a linux phone. just execute in docs-raw folder:
make htmland it builds todocsfolder. -
i dont know what a pickle file is... maybe the
nojekyllfile: without it github renders the page without styling. -
the dublicated images: sphinx/rtd works like this: you create a source folder where you write the docs, from this you can generate html, pdf, doc whatever you need
added link to osmscout-server and slim version link under ubuntu touch. ci script not done yet. ..
i added a workflow file on github, but i dont know how to run it. i am mobile only and its a freaking pain to navigate github webpage on a small verical screen (and it eats all my nerves). please someone help on this or we just use the docs as is with building manually when making changes..🤷
Actually, we should just use Github pages: https://docs.github.com/en/pages/quickstart . No special CI is needed.
Please see docs subfolder in Pure Maps - that's already runs https://rinigus.github.io/pure-maps/
Please make sure that there are no duplicated files, only sources that will be used by jekyll or some alternative to generate pages using Github server and then serve it.
meaning you want someone to redo this as github pages, right?
why not cherrypick the docs folder to at least have some documentation for now (could create a new commit for that if needed)?
meaning you want someone to redo this as github pages, right?
I want it to be easily maintainable. Its hard to find time to work on the apps, hence not much is happening here. Web site would be of great help, but it has to be simple to change. GitHub pages is surely a simple option as we will not have many copies of the same text :)