nailanawshaba / dev-workshop

GeoNode workshop for developers. How to extend and deploy

GeoNode Workshops

How to run the presentation locally

Prerequisites

Install Compass to compile graphic themes:

$ gem update --system
$ gem install compass

Make sure Compass has been successfully installed. On Ubuntu machines you may need some system packages in order to install it

$ sudo apt-get install ruby-dev

Live presentation dependencies

Install dependencies with npm and bower:

$ npm install

and

$ bower install

Serve it locally:

$ grunt serve

Open the browser at http://localhost:9000

How to add new slides

Add a new slide my-new-slide.md as a new Markdown file under the directory slides and use its syntax to create the content of that page.

The new file has to be listed as a new item in the JSON file list.json:

    {
        "filename": "my-new-slide.md",
        "attr": {
            "data-background": "css/img/bg.png"
        }
    },

Change the data-background if you want to change the background image.

How to publish online

Open the gruntfile configuration Gruntfile.coffee and change the directory for publishing the current workshop in the dest properties:

copy:

            dist:
                files: [{
                    expand: true
                    src: [
                        'slides/**'
                        'bower_components/**'
                        'js/**'
                        'css/*.css'
                        'resources/**'
                        'css/img/**'
                        'css/fonts/**'
                    ]
                    dest: 'dist'
                },{
                    expand: true
                    src: ['index.html']
                    dest: 'dist'
                    filter: 'isFile'
                }]

Run then the build with the command:

$ grunt dist

Deploy on specific folder of github pages:

$ grunt deploy

Data

Data are distributed within an archive in a directory data together the presentation and this folder can be also mounted into the virtual machine if required.