philschatz / textbooks

:books: Openstax Textbooks ported to GitHub and hosted on GH Pages

Hello!

This is a list of links to textbooks originally created by openstax.org that have been converted into GitHub repositories so you can:

• derive your own copy (aka Fork)
• suggest edits (aka Pull Request)
• report errata in the text (aka Issues) using tools GitHub provides
• read the books online instantly using GitHub Pages

The Books

The "canonical" version of the books are in openstax.org and these repositories are mirrors of those versions. These books are licensed CC-BY (or CC-BY-NC-SA) so you can customize them for your course!

• Algebra and Trigonometry
• Anatomy and Physiology
• Astronomy
• Biology
• Calculus (CC-BY-NC-SA)
• Concepts of Biology
• Chemistry
• Economics
• Microbiology
• Physics
• Psychology
• Precalculus
• Sociology
• Statistics
• US History

Each book repository contains a link at the top to view the book in a book reader. If you derive a copy, your book (and any changes you make) will be automatically hosted at http://${YOUR_GITHUB_USERNAME}.github.io/${BOOK_NAME} thanks to GitHub Pages.

What do I need to know?

If you want to customize the books you will need to:

• create a GitHub account
  • See the GitHub Guides for an introduction
• learn how to Fork a Repository (it's easy!)
  • fork one of the books listed above
• learn about Markdown, a wiki format (similar to what wikipedia uses)

If you want to view your custom book you will need to:

• do the steps above (make sure you change something about the book first!)
• go to http://${YOUR_GITHUB_USERNAME}.github.io/${THE_REPOSITORY_NAME}
  • If you see a 404 page then you probably did not change something about the book first (Try editing _config.yml and changing the title to something like Prof X's Biology Book derived from OpenStax ... and making a commit)

If you want to suggest edits (like typos or broken images) you will need to:

• learn about Pull Requests

If you want to let other people edit your version of the book you will need to:

• learn about GitHub permissions

Pulling in updates from Openstax books

Note: You can probably ignore this part

See book-updater for details.

textbooks's Issues

[enhancement] editing and commiting to repo

Hi! Great job!! I am looking for a similar tool that is able to edit on-line (using a web collaborative editor) and committing to git repo by clicking a "save" button. Is/Will this (be) possible with Textbooks?