Skip to content

Latest commit

 

History

History
60 lines (37 loc) · 2.35 KB

this-gitbook-editing-it-etc.md

File metadata and controls

60 lines (37 loc) · 2.35 KB

This GitBook; editing it, etc

What is GitBook? How to edit it?

{% hint style="info" %} See my notes on another GitBook here, on how to edit it, etc. {% endhint %}

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).

{% hint style="info" %} Also consider our 'style guide' linked here (for this and other communications) {% endhint %}

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

{% hint style="info" %} 18 Jun 2023 -- needs moving after moving GitBook location {% endhint %}

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:

{% code overflow="wrap" %}

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'); })()

{% endcode %}

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:

{% code overflow="wrap" %}

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'); })()

{% endcode %}