[!WARNING] This project is no longer maintained. The repository has been archived and is read-only. No further updates, issues, or pull requests will be accepted. PyPI packages will still remain available but will be marked as inactive.

If you are interested in continuing development, please feel free to fork this repository and maintain your own version.

Thank you to everyone who used and contributed to this project :heart:

orbelican

A simple port of orbit-theme for the Pelican static site generator to build your online resume

Getting started

Configuration

To avoid problems make sure these configuration variables are filled in pelicanconf.py

THEME = "orbelican"

AUTHOR = ''
SITENAME = ''
SITEURL = ''
TIMEZONE = ''
DEFAULT_LANG = ''

PATH = "" # leave this variable empty, there is no content to look for (except data files)
ARTICLE_EXCLUDES = [".env"] # exclude your venv

FEED_ALL_ATOM = None
CATEGORY_FEED_ATOM = None
TRANSLATION_FEED_ATOM = None
AUTHOR_FEED_ATOM = None
AUTHOR_FEED_RSS = None

# set all these variables on false, because we only want to generate index.html
DEFAULT_PAGINATION = False
LOAD_CONTENT_CACHE = False
TAGS_SAVE_AS = False
AUTHORS_SAVE_AS = False
CATEGORIES_SAVE_AS = False
ARCHIVES_SAVE_AS = False

Customization

Data

This theme support pelican-data-files plugin.

This plugin loads all the data files found in the project's data/ directory, and makes them accessible [...]

First, fetch sample data from the theme with the following command:

pelican-data-files --fetch orbelican

A data/ folder must have been created, you can modify these files in order to personalize the site.

Add custom profile picture and favicon

Copy your best profile picture in your site project in images/ folder and edit the config.json to set proper filename to profile attribute. Do the same for customize your favicon.

Generate your website

You can generate the site with the simple command:

pelican

Note: you can also easily serve the site by running the following command:

pelican -l

Contributing

To build css files from sass, run the task sass:

invoke sass

Note: make sure you have installed dev dependencies.

License

This Bootstrap template [...] is 100% FREE as long as you keep the footer attribution link.

This is a port of orbit-theme for Pelican, it can be used for free if you keep the footer attribution link.

If you'd like to use the template without the attribution link, you can buy the commercial license via the theme website

If you have paid for the license you can hide the footer by setting the configuration variable SHOW_FOOTER = True in your pelicanconf.py

The above quotes come from the original theme github repository.

MIT License

Copyright (c) 2020 vhash

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.