# Welcome

Welcome to the online home of Geocomputation with R, a forthcoming book with CRC Press.

## Development

Inspired by bookdown and other open source projects we are developing this book in the open. This approach encourages contributions, ensures reproducibility and provides access to the material as it evolves.

The book development can be divided into three main phases:

1. Foundations
2. Extensions
3. Applications

New chapters will be added to this website as the project progresses, hosted at geocompr.robinlovelace.net and kept up-to-date thanks to Travis which ensures the reproducibility:

The version of the book you are reading now was built on 2018-05-23 and was built on Travis.

## How to contribute?

bookdown makes editing a book as easy as editing a wiki, provided you have a GitHub account (sign-up at github.com). Once logged-in to GitHub, click on the ‘edit me’ icon highlighted with a red ellipse in the image below. This will take you to an editable version of the the source R Markdown file that generated the page you’re on:

To raise an issue about the book’s content (e.g. code not running) or make a feature request, check-out the issue tracker.

## Reproducibility

To reproduce the book, you need a recent version of R and up-to-date packages, which can be installed with the following command (which requires devtools):

devtools::install_github("robinlovelace/geocompr")

To build the book locally, clone or download the geocompr repo, load R in root directory (e.g. by opening geocompr.Rproj in RStudio) and run the following lines:

bookdown::render_book("index.Rmd") # to build the book
browseURL("_book/index.html") # to view it

Further details can be found at github.com/Robinlovelace/geocompr.