Skip to content

Course materials for year 2017, Department of Geosciences and Geography, Uni. Helsinki

Notifications You must be signed in to change notification settings

geo-python/2017

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Geo-Python

This repo contains the source files of course material available at https://geo-python.github.io/2017/

The course you to the basic concepts of computer programming in the Python programming language.

Course topics

Lecture notes

Building the GitHub-pages

This course website has been constructed in a similar way as the full automating GIS-processes pages. The pages are built using Sphinx with modified version of the Read The Docs theme. The following packages are needed in order to modify the pages (We recommend using conda from Anaconda Python distribution package):

  • Sphinx

    conda install -c anaconda sphinx=1.5.1
    
  • Read The Docs Theme

    conda install -c anaconda sphinx_rtd_theme=0.1.9
    

.rst files

Sphinx uses .rst -files (reStucturedText), and thus the source for the pages need to be written into .rst-files. Markdown-dokuments .md can be converted to .rst -format using Pandoc_convert_md_to_rst.py (converts all .md-files from the source directory to .rst-files).

.rst -files for these course pages are found under the source -folder, and .html pages in the docs -folder (these are automatically generated using the make.bat command, see below).

Building the pages

Shinx pages need to be built into html-format before publishing online.

  • If you are starting from scratch, make sure you have a branch gh-pages.

git branch -a

If you can't see gh-pages in the list (in addition to master-branch), create it using

git branch gh-pages -command in the Terminal-window (you only need to do this once!)

Generate html-files

  • html-pages are built using the make.bat -batchfile:

make html (html-files will be under the docs-folder in the master-branch - useful if you don't want to publish changes straight away!)

make gh-pages (html-files are generated under the docs-folder in the gh-pages-branch - by default changes will be published online)

  • Note! When building site with make gh-pages it is necessary to have a folder called data with at least a single template file in the root of the repo. Typically you end up having there many files but it is important to have at least a single file there when starting to build your site.

Publish gh-pages online

  • in GitHub, go to settings-page of the repo and set the Source for GitHub Pages to gh-pages branch.

About

Course materials for year 2017, Department of Geosciences and Geography, Uni. Helsinki

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published