Multiple GitBooks inside main git repository?

Question

I'm planning to use GitBook for publishing user/system documentation for a large project. Documentation is organized as a collection of self-contained books, expected to be managed inside the main git repository like:

- root
  - sources
  - books
     - tutorial
       - assets
       - section-1
       - …
     - reference
       - …

Is it feasible to sync each book directory to an independent GitBook repository?

Bonus: is it feasible to have each GitBook repository automatically mirror the branching/tagging structure of the main repository?

score 0 · Accepted Answer · edited May 23 '17 at 12:06

sync each book directory to an independent GitBook repository?

You can if each book is in its own folder, declared as a submodule

is it feasible to have each GitBook repository automatically mirror the branching/tagging structure of the main repository?

Not exactly: a submodule has no knowledge of the parent repo. But you can configure a submodule to follow one of its branches.

That allows, form the parent repo, to do a:

git submodule update --remote

That will fetch the latest from the branch followed by each submodules.

Multiple GitBooks inside main git repository?

1 Answers1