# This GitBook; editing it, etc

## What is GitBook? How to edit it?

{% hint style="info" %}
See my notes on [another GitBook here](https://effective-giving-marketing.gitbook.io/untitled/appendix/how-this-gitbook-works), 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](https://docs.google.com/document/d/10aooH_YCVX__pXFqnY1l8Kn2_DPX9wdHdR9AfImSuDs/edit?usp=sharing) (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)

![](https://3160292658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb1RpEkRWWqZAV4SlrFCt%2Fuploads%2Fgit-blob-4b2b4cbf6420748b96872415b455ea3c49dd57f0%2Fimage%20\(6\).png?alt=media)

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 %}