Website for KnowlegeFinder

Homepage (landing page) and announcements for KnowledgeFinder (http://knowledgefinder.github.io).

Based on Pelican and a modified Polar theme by CodePassenger.

Local Installation

Install Python (Anaconda works perfectly)
Install Pelican and supporting libraries

pip install pelican
pip install markdown
pip install fabric
pip install ghp-import

or if you are using Windows

pip install https://github.com/chevah/ghp-import/archive/win-support.zip

Clone KnowledgeFinder

git clone https://github.com/KnowledgeFinder/knowledgefinder.github.io.git

git clone git@github.com:KnowledgeFinder/knowledgefinder.github.io.git

Change to KnowledgeFinder/
Switch to source branch.

git checkout source

Configuration

Set proper port for local testing which works on your machine in fabfile.py

# Port for `serve`
PORT = 8001

Build

Generate website

fab build

(If you are using Windows and are getting the error ImportError: No module named Crypto.PublicKey, rename the crypto folder in site-packages to Crypto.)

Start local server for testing (accessible via http://localhost:[port]/)

fab serve

Convenience target for rebuild and starting local server

fab reserve

Deployment

Writing Content

Use either Markdown or HTML for new articles, as described in Writing content.

Add new articles to content.

Metadata

The required meta data for KnowledgeFinder release announcements are:

Title: Release 1.0 
Date: 2016-09-20 12:00
Category: Releases
Author: KnowledgeFinder

Image sizes

Article image: 870x440 px (doesn't apply for the overview image of the article)
Thumbnail large: 100x108
Thumbnail small: 67x73

Deploy output to master

After building the website, deploy the page to master and push it:

fab gh_pages

KnowledgeFinder/knowledgefinder-website-archive