Introduction
Last updated
Last updated
This document is a part of Aurelia-Tools internal documentation library. It describes the process of its own creation using only the browser to do it.
Point your browser to our GitBook main page: and click on the + NEW button (Image 1, below)
Image 1
This should result with the Create a new book dialog: (Image 2 below). Define your choices in the order suggested by red markers.
Image 2
I also deleted the "Chapter 1" page that is a part of the template selected with the click on item tagged with red marker 1 on the Image 2 above. For this document, a single page is sufficient.
create the new repository in GitHub that should have the same or similar name to your current repository on GitBook, created as the consequence of the action in step 1. Create a new book above.
get the git url of your GitBook book repository which is typically defined as https://git.gitbook.com/MyName/MyBook.git
-clone this book to your machine
push this local clone to the newly created GitHub based repository (with the intent to ovewrite that destination.
Image 3
This is the critical step that is not well explained in the existing documentation.
Image 4
Click on Create repository buttom (marker 5, Image 4) results with the new GitHub repo with the URL https://github.com/aurelia-ui-toolkits/GitBook-books-living-in-GitHub
This is simply done as:
Again, using your console, you need to do your equivalent of this
Point the browser to https://github.com/aurelia-ui-toolkits/GitBook-books-living-in-GitHub and observe:
Image 5
Image 6
Click on the Browse directory icon (Image 6, marker 1) will bring the list of all GitHub integrations. Scroll down until you see the GitBook icon
Image 7
Click on the GitBook icon establishes the needed relationship, where your book is stored in GitHub, can be edited by GitBook web editor and will be hosted (as a web site) at GitBook.
Image 8
Edit the book source in GitHub (the file README.md which is the only remaining page in the book after the file Chapter 1 was deleted when this book was created) - directly on GitHub, using the browser. Save that book and access it via URL https://aurelia-ui-toolkits.gitbooks.io/gitbooks-living-in-github/content/ that points to the GitBook website. Verify that the change just made appears on the book viewed as a page on GitBook web server.
Now, our book is created and can be accessed via URL and as the URL suggests, it is persisted on the gitbooks.io server - not in GitHub.
The summary of actions described - section Using the command line is:
Point your browser to and click on the SETTINGS link (Image 3 below)
In order to associate the with your book stored in GitHub, click on the Settings link (Image 5, marker 1). This will result with
