Welcome to the GITenberg documentation!
How can you contribute?
We are currently working on converting and editing our first 100 books.
For now there are a few things you can do depending on your interest and skill level. Firstly, if you find an error or typo in any of the books, report it in the 'Issues' tab on that repo. If you would like to offer changes: fork, edit and create a Pull Request. If you would like to make suggestions, help in another way, or would like to get more involved, you can join the project mailing list.
You can read the full text of the last project status report here.
Infrastructure Documentation — Descriptions of the various systems (current and future) that run GITenberg.
[Github post-commit hooks] — how we know when to rebuild ebooks when changes are made to repos
[Book repo digestor] — Receives a book repo, decides what to do based on the content of the repo
Metadata Development - How GITenberg describes the data in a repo.
Step 1 is to create a list of ebook repos we’ll use as a testbed for the GITenberg tool chain. The current list is maintained on [this file][active-repos]. Instructions on including a new repo are available
How to generate covers for the books?
What will be the source format?
Discussion is still open, but asciidoc is the current best candidate.
How are the repositories created?
What is the reference format from PG?
How to cope with punctuation?
There is consensus to convert when possible ascii punctuation to unicode more precise equivalents.
What is the licensing big schema?
Every book on PG gets its own repository. All are listed on the gitenberg organization github page, here.
There’s a tsv file with a full list of repo names at https://github.com/gitenberg-dev/giten_site/blob/master/assets/GITenberg_repos_list_2.tsv
There is work going on on several repositories. The central point for development is the gitenberg-dev organization, whose repos can be seen on its github firstname.lastname@example.org:sethwoodworth/GITenberg.git[page].
Readmes, introductions and FAQs
Several pieces of information are scattered around. This one is intended to replace all of them but for the main gitemberg page, which serves as first contact. All the others are being amended to point to this document.