Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Move away from Gitbook #238

Open
albar965 opened this issue May 19, 2018 · 0 comments

Comments

@albar965
Copy link
Owner

commented May 19, 2018

The new Gitbook dropped PDF generation and the open toolchain. This will not allow to generate documentation off-site: This will end in a complete dependency on Gitbook. New features are completely irrelevant anyway.
Even worse: There is no code versioning like in Git and editing can only be done in the web gui.

Compiling fails several times in a row and support does not care.

Gitbook FAQ shows the limitations.

The Plan

  • Keep Gitbook manuals as reference for various posts that link into the manual.

  • Manuals have to be edited on GitHub where they are already mirrored.

  • Collaborators have to move to GitHub.

  • Get a web site www.littlenavmap.org (virtual or dedicated server)

  • Generate manual locally using Gitbook tools and upload to site (https://www.littlenavmap.org/manuals/littlenavmap/release/2.2/)

  • LNM 2.2.4 refers to the new site.

  • Detach Gitbook from Github after compiling the last time for 2.2.4

  • Move from Gitbook tools to Daux.io to create more appealing manuals

  • Automate generation process and run it on the LNM site by regular pulling from GitHub

  • Set up Wordpress instance on site for news, updates and more or move Github site to new one.

Alternatives for document generation:

@albar965 albar965 added the internal label May 19, 2018

@albar965 albar965 self-assigned this May 19, 2018

@albar965 albar965 added this to the Release 2.2 milestone Sep 14, 2018

@albar965 albar965 closed this Nov 18, 2018

@albar965 albar965 reopened this Nov 18, 2018

@albar965 albar965 modified the milestones: Release 2.2, Release 2.2.X Dec 3, 2018

@albar965 albar965 added the in progress label Feb 1, 2019

albar965 added a commit that referenced this issue Feb 2, 2019

albar965 added a commit to albar965/atools that referenced this issue Feb 4, 2019

albar965 added a commit to albar965/atoolstest that referenced this issue Feb 4, 2019

albar965 added a commit to albar965/littlenavconnect that referenced this issue Feb 4, 2019

albar965 added a commit to albar965/littlexpconnect that referenced this issue Feb 4, 2019

albar965 added a commit to albar965/navdatareader that referenced this issue Feb 4, 2019

@albar965 albar965 modified the milestones: Release 2.2.4, Release 2.4 Feb 9, 2019

@albar965 albar965 removed the in progress label Feb 11, 2019

@albar965 albar965 modified the milestones: Release 2.4, Release 2.6 May 29, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
1 participant
You can’t perform that action at this time.