Skip to content

hlgrondijs/dev.dbpedia.org

 
 

Repository files navigation

dev.dbpedia.org

Developer Documentation at http://dev.dbpedia.org

Requirements

apt-get install jekyll curl crontab

Installation

git clone https://github.com/dbpedia/dev.dbpedia.org.git
cd dev.dbpedia.org && ./generate-markdown.sh

# -H 0.0.0.0 for external access 
jekyll serve -H 0.0.0.0 -P 4444

It is also possible to serve only the generated _site/ folder as html.

Content

To generate a new page, the readme-list.csv contains entries with the attributes: "headline", link to the "external repo", the "direct link to the external markdown file", and if it should be a subsection of a "parent menu entry".

To add static content add/edit files in the markdown folder and then include it as the same way as the external markdowns in the readme-list.tsv.

Sidebar

Configured in _includes/sidebar.html. Sorted alphabetically with the following code

...
{% assign pages_list = site.pages | sort:"title" %}
...

Automatic Update

To update external markdown every hour, add following entry to your crontab.

crontab -l > tmpcron
# skip first line if crontab is empty.
# enter dev.dbpedia.org repo folder.
echo "*/10 * * * * /bin/sh -c 'cd `pwd` && /usr/bin/git pull -q origin master && ./generate-markdown.sh'" >> tmpcron
crontab tmpcron && rm tmpcron

Docker w/o cronjob

Docker can be used to deploy the jekyll webserver. Beware it does not support cronjobs for now.

docker build -t dev.dbpedia.org .
# run on host port 4000 with live rendering of changes in contents and markdown folder
docker run -p 4000:80 -v "$(pwd)":/root dev.dbpedia.org

About

Developer Documentation at http://dev.dbpedia.org

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 77.4%
  • HTML 15.5%
  • Shell 6.0%
  • Dockerfile 1.1%