This GitBook; editing it, etc

What is GitBook? How to edit it?

See my notes on another GitBook here, on how to edit it, etc.

Some quick points:

  • GitBook is mainly used for tech documentation; but it has some important strengths and it's pretty good for general use.

  • It is based in markdown and other simple flat text files.

  • It synchronizes through Git/Github, and you can push and pull ... but you can also select "edit" and "merge" and use it fairly WYSIWYG.

  • They have a good support team (try their chat/help button).

Also consider our 'style guide' linked here (for this and other communications)

Shortcut for switching between public and private versions of the same page

18 Jun 2023 -- needs moving after moving GitBook location

Switching between the public and private versions of GitBook (while maintaining the same relative page) is a pain.

Semi-automate: going from the editable to the public version with a 'bookmarklet'

Setting the following as a ‘bookmark’ seems to help (Chrome: bookmarks manager, edit any existing bookmark by right click --> edit)

Name: “Switch to Public GitBook page” (or whatever)

URL: set to:

javascript:(function() { var publicUrl = document.location.href.replace('app.gitbook.com/o/-MfFk4CTSGwVOPkwnRgx/s/b1RpEkRWWqZAV4SlrFCt', 'globalimpact.gitbook.io/the-unjournal-project-and-communication-space/'); window.open(publicUrl, '_blank'); })()

To go in the other direction (public to editable version of a page)

Setting the following as a "bookmark" seems to help (chrome: bookmarks manager, edit any existing bookmark by right click --> edit)

Name: “Switch to Editable GitBook page” (or whatever)

URL: set to:

javascript:(function() { var editableUrl = document.location.href.replace('globalimpact.gitbook.io/the-unjournal-project-and-communication-space/', 'app.gitbook.com/o/-MfFk4CTSGwVOPkwnRgx/s/b1RpEkRWWqZAV4SlrFCt/'); window.open(editableUrl, '_blank'); })()

Last updated