Jekyll: Difference between revisions

From UMIACS
Jump to navigation Jump to search
(Created page with "Jekyll is a blog-aware, static site generator. Rather that relying on a server side scripting language and a database, as many CMS solutions often do, Jekyll allows you to qui...")
 
No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Jekyll is a blog-aware, static site generator. Rather that relying on a server
[https://jekyllrb.com/ Jekyll] is a blog-aware, static site generator. Rather that relying on a server
side scripting language and a database, as many CMS solutions often do,
side scripting language and a database, as many CMS solutions often do,
Jekyll allows you to quickly deploy your site to any web tree that can serve
Jekyll allows you to quickly deploy your site to any web tree that can serve
static files (perfect for the Object Store!). Jekyll provides a templating
static files (perfect for the [[OBJ | Object Store]]!). Jekyll provides a templating
language and data format that allows you to design your site using HTML, CSS,
language and data format that allows you to design your site using HTML, CSS,
and Javascript and then render in the site's content. This separation of
and Javascript and then render in the site's content. This separation of
Line 9: Line 9:
Jekyll compiles your templates and content files into full HTML!
Jekyll compiles your templates and content files into full HTML!


A great example of a Jekyll-generated site is the UMIACS Intranet page!
A great example of a Jekyll-generated site is the [https://intranet.umiacs.umd.edu/ UMIACS Intranet page]!


==Create a Jekyll Site==
==Getting Started==
We have a template with instructions to get started [https://gitlab.umiacs.umd.edu/docker/jekyll-builder here].
These instructions are taken from the official Jekyll [https://jekyllrb.com/docs/ quickstart guide].
# Install all the [https://jekyllrb.com/docs/installation/ prerequisites] to run Jekyll.
# Install the jekyll and bundler gems. <pre>gem install jekyll bundler</pre>
# Create a new Jekyll site at ./mysite (use a better name of your choosing). <pre>jekyll new mysite</pre>
# Change into your new directory. <pre>cd mysite</pre>
# Build the site and make it available on a local server. <pre>bundle exec jekyll serve</pre>
# Browse to http://localhost:4000
 
==Publishing a Jekyll Site==
We have instructions to get started [https://gitlab.umiacs.umd.edu/docker/jekyll-builder here] on how to publish your site to the Object Store.  It can be configured to publish automatically every time you push updates to [[GitLab]].

Latest revision as of 15:09, 24 November 2020

Jekyll is a blog-aware, static site generator. Rather that relying on a server side scripting language and a database, as many CMS solutions often do, Jekyll allows you to quickly deploy your site to any web tree that can serve static files (perfect for the Object Store!). Jekyll provides a templating language and data format that allows you to design your site using HTML, CSS, and Javascript and then render in the site's content. This separation of design and content allows for easy editing and reuse of your own custom desgin templates and those made by others. When ready to update the content, Jekyll compiles your templates and content files into full HTML!

A great example of a Jekyll-generated site is the UMIACS Intranet page!

Getting Started

These instructions are taken from the official Jekyll quickstart guide.

  1. Install all the prerequisites to run Jekyll.
  2. Install the jekyll and bundler gems.
    gem install jekyll bundler
  3. Create a new Jekyll site at ./mysite (use a better name of your choosing).
    jekyll new mysite
  4. Change into your new directory.
    cd mysite
  5. Build the site and make it available on a local server.
    bundle exec jekyll serve
  6. Browse to http://localhost:4000

Publishing a Jekyll Site

We have instructions to get started here on how to publish your site to the Object Store. It can be configured to publish automatically every time you push updates to GitLab.