Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/philschatz/textbooks

:books: Openstax Textbooks ported to GitHub and hosted on GH Pages
https://github.com/philschatz/textbooks

biology calculus cc-by cc-by-nc-sa free openstax physics psychology statistics textbook

Last synced: 21 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/philschatz/textbooks
Owner: philschatz
Created: 2016-04-04T02:23:31.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2017-04-20T18:21:00.000Z (almost 8 years ago)
Last Synced: 2024-11-19T15:56:22.106Z (3 months ago)
Topics: biology, calculus, cc-by, cc-by-nc-sa, free, openstax, physics, psychology, statistics, textbook
Homepage: http://philschatz.com/books
Size: 1.95 KB
Stars: 47
Watchers: 4
Forks: 9
Open Issues: 1
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        # Hello!

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

- **derive your own copy** (aka [Fork](https://help.github.com/articles/fork-a-repo/))

- **suggest edits** (aka [Pull Request](https://help.github.com/articles/proposing-changes-to-a-project-with-pull-requests/))

- **report errata** in the text (aka Issues) using tools GitHub provides

- **[read the books online instantly](http://philschatz.com/books/)** using `GitHub Pages`

# The Books

The "canonical" version of the books are in [openstax.org](http://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](https://github.com/philschatz/algebra-trigonometry-book)

- [Anatomy and Physiology](https://github.com/philschatz/anatomy-book)

- [Astronomy](https://github.com/philschatz/astronomy-book)

- [Biology](https://github.com/philschatz/biology-book)

- [Calculus](https://github.com/philschatz/calculus-book) (CC-BY-NC-SA)

- [Concepts of Biology](https://github.com/philschatz/biology-concepts-book)

- [Chemistry](https://github.com/philschatz/chemistry-book)

- [Economics](https://github.com/philschatz/economics-book)

- [Microbiology](https://github.com/philschatz/microbiology-book)

- [Physics](https://github.com/philschatz/physics-book)

- [Psychology](https://github.com/philschatz/psychology-book)

- [Precalculus](https://github.com/philschatz/precalculus-book)

- [Sociology](https://github.com/philschatz/sociology-book)

- [Statistics](https://github.com/philschatz/statistics-book)

- [US History](https://github.com/philschatz/us-history-book)

Each book repository contains a link at the top to view the book in a [book reader](http://philschatz.com/books). 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](https://pages.github.com/).

# 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](https://guides.github.com/) for an introduction

- [learn how to Fork a Repository](https://guides.github.com/activities/forking/) (it's easy!)

  - fork one of the books listed above

- [learn about Markdown](https://guides.github.com/features/mastering-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](./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](https://help.github.com/articles/proposing-changes-to-a-project-with-pull-requests/)

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

- [learn about GitHub permissions](https://help.github.com/articles/permission-levels-for-a-user-account-repository/)

# Pulling in updates from Openstax books

**Note:** You can probably ignore this part

See [book-updater](https://github.com/philschatz/book-updater) for details.