pelican-fh5co-marble icon indicating copy to clipboard operation
pelican-fh5co-marble copied to clipboard

freehtml5.co Marble design for pelican

Description

pelican-fh5co-marble is a layout from https://freehtml5.co/ ported to pelican.

Features

  • Fully responsive
  • Translation support
  • Working contact form (sending is done in php)
  • Integrated tipue_search Plugin
  • Google Maps integration
  • Disqus integration

Todo's for later version

  • ADs
  • Facebook/Twitter share

Plugins

  • https://github.com/getpelican/pelican-plugins/tree/master/i18n_subsites
  • https://github.com/getpelican/pelican-plugins/tree/master/tipue_search

Example blog

You can find a fully working example under https://github.com/claudio-walser/pelican-fh5co-marble-example

.. code:: console

git clone https://github.com/claudio-walser/pelican-fh5co-marble.git
git clone https://github.com/claudio-walser/pelican-fh5co-marble-example.git
cd pelican-fh5co-marble-example
pelican
./develop_server.sh start 8081

Then visit http://localhost:8081 with your browser.

Contact Form

To get the contact form working, you need to change SMTP Login values in output/theme/mail-config.php For security reasons, NEVER check in this file anywhere but replace values in the output folder of your Pelican Blog manually or by script. Personally I build my pelican sites using jenkins and there i have a build step which is replacing SMTP Login values after the pelican build.

.. code:: php

<?php

define('SMTP_SERVER', 'mail.your-domain.com');
define('SMTP_PORT', 587); # usually, only smtp over tls is supported
define('SMTP_REALNAME', 'John Doe');
define('SMTP_USER', '[email protected]');
define('SMTP_PASS', 'secret');

define('RECIPIENT', '[email protected]');
define('RECIPIENT_REALNAME', 'John Doe');

?>

Credits

  • Layout by https://freehtml5.co/
  • Example Images by David Kaplan http://www.kplan.ch/
  • And thanks to Alexandre Vicenzi, creator of the great Flex theme for many impressions and how to's https://github.com/alexandrevicenzi/Flex

Translations

Pull Request with more translations are very welcome. Languages in the theme right now

  • English
  • German
  • Hebrew (credits go to https://github.com/tsvi)
  • French (credits go to https://github.com/MaevaBrunelles)
  • Spanish (done with google translate)
  • Polish (credits go to https://github.com/przymusp)
  • Italian (credits go to https://github.com/aleppax)

To create a new language, execute translations.sh

.. code:: console

./translations.sh new ru_RU

Then translate the strings in ./locale/ru_RU/LC_MESSAGES/messages.po Afterwards call translations.sh with compile

.. code:: console

./translations.sh compile

Again, thanks to Alexandre Vicenzi because I copied his script.

Issues or feature-requests

If you discover any bugs, feel free to create an issue on GitHub or fork and send me a pull request.

Issues List_.

Authors

  • Claudio Walser (https://github.com/claudio-walser)

License

https://creativecommons.org/licenses/by/3.0/

.. _Issues List: https://github.com/claudio-walser/pelican-fh5co-marble/issues

Screenshots

.. image:: screenshot-home.png :width: 100%

.. image:: screenshot-home-2.png :width: 100%

.. image:: screenshot-contact.png :width: 100%