/lezoudali.github.io

Personal blog using github pages and jekyll

Primary LanguageCSSOtherNOASSERTION

About

Emerald is a minimal theme created for Jekyll. The main purpose of Emerald is to provide a clear theme for those who want a blog ready to use, focused on the content and mobile-first.

Emerald

Setup & usage

Emerald may be installed by simply downloading the .zip folder frome the repository on Github.

After extracting the content from the folder into the selected directory, you can type jekyll serve from the terminal, than open your browser to 0.0.0.0:4000/emerald/ and you will find there.

Additionally it is possible to fork the repository and using Github Pages as hosting. By following this way it will enough change the baseurl value into the _config.yml file, with the directory name of your project (for example /blog) or with a simply "/" (slash) if you want install Emerald in the root.

Branch

Emerald has two branch:

  • master: is for developing pourpose.
  • gh-pages: is only for demo site.

Baseurl

Emerald was tought to be used mainly with Github, in particular into project site. For this reason they have been included several tags {{ site.baseurl }} to refer to the "/emerald/" directory. You can change the "baseurl" value into the config.yml file, to match your directory (for example "/blog/") or the root of your project. In that case you must set the "baseurl" value to "/".

Typography

To maintain the vertical rythm, it has been applied a Typographic scale as a modular scale, with a baseline set to 24px. To maintain this rythm you need to insert elements like image, video or other contents with a 24px (or multiple) height as refer.

Last but not last: the Jekyll documentation is the best starting point!

Author

Jacopo Rabolini

License

Emerald is released under MIT License.