Python Users Group Nepal Website

This is the repo for the Python User Group Nepal's website. The site is built using Pelican, a static site generator, powered by Python. The site's theme is based on Pure Pelican Theme.

Find us

Setup for local development

Fork repo

Fork the repository to your account so that you have your copy of the website.

Clone repo

  $ git clone --recursive git@github.com:<your-username>/pythonnepal.github.io.git pynepal-website

This will clone the repository on to your system and clone the submodules inside it as well recursively. Additionally, the folder to which it will be cloned to is called pynepal-website.

Set up a virtual env in that folder and activate it

  $ cd <repo>
  $ virtualenv venv
  $ source venv/bin/activate

Install the requirements using pip from inside the virtual environment
```
  (venv)$ pip install -r requirements.txt
```
Start the server
```
  fab serve
```
Visit local site

Open up your web browser and point it to http://localhost:8000 to see the site running locally. Yay!

Blog Workflow

If you're interested in writing a blog post for the website, you need to:

Fork the repository
Write a blog post using Markdown in the content directory
Push the changes to a topic branch, like an-example-article, on your fork of the repository
Make a pull request against the master branch.

Deployment

We use Fabric for automating the tasks and deployment. Type fab --list to see the available commands.

Available commands:

    build       Build local version of site
    clean       Remove generated files
    preview     Build production version of site
    publish     Push the generated html to master branch on GitHub.     
    rebuild     `clean` then `build`
    regenerate  Automatically regenerate site upon file modification
    reserve     `build`, then `serve`
    serve

Contributing

See CONTRIBUTING.md

If you're a python developer from Nepal, you can add yourself to the website. To do that,