Gitbook

[adriatic]

I had all kinds of problems trying to clone from gitbook to github "directly"; I tried to push from gitbook and pull from github - nothing good happened. So, I tried the indirect way using my PC as the intermediary

Current situation: I managed to make a local clone of the kendoui-bridge-docs book using this process

C:\work\aurelia-ui-toolkits\KendoUI\kendo-books
λ git clone https://git.gitbook.com/aurelia-ui-toolkits/kendoui-bridge-docs.git
Cloning into 'kendoui-bridge-docs'...
Username for 'https://git.gitbook.com': adriatic
Password for 'https://[email protected]':
remote: Counting objects: 1094, done.
remote: Compressing objects: 100% (1027/1027), done.
Receiving objects: 100% (1094/1094), 151.56 KiB | 0 bytes/s, done.
Resolving deltas: 100% (626/626), done.
Checking connectivity... done.

The, I created a new GitHub (empty) repository - https://github.com/aurelia-ui-toolkits/aurelia-kendoui-books initialized with the README.md file only.

Note that my local clone of the whole book from gitbook is in the kendo-book folder and that the local clone of the empty book from github is in aurelia-kendoui-books folder.

Now, I copied (windows explorer) complete content of the kendo-book folder into the (almost empty) aurelia-kendoui-books folder.

Lastly I commited all changes in aurelia-kendoui-books folder and pushed it to https://github.com/aurelia-ui-toolkits/aurelia-kendoui-books repository.

This means that we have a clone of the book at https://aurelia-ui-toolkits.gitbooks.io/kendoui-bridge-docs/content/ in Github - and that is a good thing.

What is still missing? Well, what happens if I open this book for edit? Which sources are used by the gitbook web editor? sources from github or sources from github? It seems that it reads from the latter, based on this view:

This matches the setting I put in https://www.gitbook.com/book/aurelia-ui-toolkits/kendoui-bridge-docs/settings/github -

However, the repo https://github.com/aurelia-ui-toolkits/aurelia-kendoui-books is a clone of the gitbook original - so why am I not seeing the same content now?

[adriatic]

How not to have to copy the whole book content into a new branch?

The key purpose of the above exercise was to create a clone of the current book and pare it down using the Gitbook Editor to the minimum needed for the KendoUI bridge beta documentation.

Other than installing gitbook desktop editor and use it to massage my local clone of the book, I do not see other alternative. The gitbook support is completely ignoring my questions so far (probably because we have the free OSS account ??)

[adriatic]

Temporary summary:

Cloning

• The git url for the instance hosted by GitBook is definitively https://git.gitbook.com/aurelia-ui-toolkits/kendoui-bridge-docs.git. I successfully used this url to clone this instance to my PC.

• There is very likely a problem with Single Sign-On at GitBook. I created all books using my GitBook account and my initial attempt to clone this book (form GitBook) failed at the point pf presenting my authentication in the process of running the command

  git clone https://git.gitbook.com/aurelia-ui-toolkits/kendoui-bridge-docs.git
  

  Only after I created my "direct credentials" with GitBook, (using the same username / password - something dat is not likely relevant in this context), was I able to clone the book.

Editing

• If there is no Github address specified at https://www.gitbook.com/book/aurelia-ui-toolkits/kendoui-bridge-docs/settings/github then the GitBook web editor correctly shows the book content in the edit mode:

  https://www.gitbook.com/book/aurelia-ui-toolkits/kendoui-bridge-docs/edit#/edit/master/README.md
  

• If I specify the Github address using this specific format aurelia-ui-toolkits/aurelia-kendoui-books in the field at https://www.gitbook.com/book/aurelia-ui-toolkits/kendoui-bridge-docs/settings/github and then open the GitBook Editor in the edit mode, it would show empty Table of Content and the correct content of the Files Tree.