This is the source code for my personal site
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_layouts
_python
about
blog
ci
contact
css
images
js
misc
papers
pdf
posters
research
software
tag
talks
teaching
.gitignore
.nojekyll
.travis.yml
CNAME
LICENSE.md
Makefile
README.md
_site.yml
environment.yml
index.md
qualitec2014.md
rss.md

README.md

Souce code for leouieda.com

Build Status Powered by Urubu

This is the source code for my personal site leouieda.com.

Dependencies

You'll need to install Urubu and all it's dependencies to build the site. I have been using Python 3.5 for the build. See environment.yml for the complete dependency list.

You can create a conda environment with all required dependencies by running conda env create in the root of the repository. To activate the environment and run the build use source activate urubu.

Compiling the site

Use the Makefile:

make
make serve

The command make serve will start a simple server at the _build folder where the built HTML files are. Point your browser to http://127.0.0.1:8000 to view the site. The server runs in the background so you can continue working on the site.

The theme

The website theme is made using bootstrap and tweaked from the Cosmo Bootswatch theme. Icons are provided by FontAwesome and Academicons.

The Jinja2 templates and CSS are located in the _layouts and css folders. I really should make this theme more generic and provide it to the world. But, you know, time and things. You can still use it by copying the folders to your own project. I can't guarantee that things will work without my specific folder structure.

Adding an article/talk/course/software

The papers, talks, courses and software entries are .md files in the corresponding folders. The site theme takes a lot of extra metadata in the post to make the "Info" section of each entry.

To add a new entry, create the .md file in the corresponding folder.

Metadata for entries

The template makes extensive use of metadata entries for pages. You can specify things like the DOI, Github repository, etc and the template will include it in the publication side bar. See the existing publications for examples.

Automatic deploy with TravisCI

The site is automatically built and deployed to leouieda/leouieda.github.com every time a commit is pushed to the master branch. See files .travis.yml and ci/deply-gh-pages.sh.

License

Creative Commons License Except were otherwise noted, this work is licensed under a Creative Commons Attribution 4.0 International License.

All source code is distributed under the BSD 3-clause License.