Personal Blog created with Jekyll and the gorgeous gem-based theme Minimal Mistakes.
Open up Tilix terminal and set up the project in your code directory:
$ sudo apt install git ruby
$ mkdir code
$ cd code
$ git clone [email protected]:netzfisch/lolasview.com.git
$ cd lolasview.com
$ bundle install
This only needs to be done once!
To write a new posts, simply add a file in the _posts/
directory that
follows the naming convention YYYY-MM-DD-name-of-post.md
, edit the post with
gedit text editor and include necessary front matter (title, excerpt, header
image/teaser, categories, tags, etc.).
Use the file manager to look at the source of existing blog posts and check markdwon syntax to get an idea how to format text and add hyperlinks! To see it in the context of the theme look parallel at the formated post vs. the raw version.
Images need to be placed in the folder assets/imgages/
with following name
convention about name and dimension
..._header.jpg
with a 3:1 ratio: 1200x400 pixel (banner)..._large.jpg
with a 1:1 ratio: 800x800 pixel (square)..._large.jpg
with a 4:3 ratio: 800x600 pixel (postcard)..._small.jpg
with a 2:3 ratio: 300x450 pixel (portrait)..._small.jpg
with a 3:2 ratio: 300x200 pixel (postcard)..._teaser.jpg
with a 3:2 ratio: 300x200 pixel (teaser)
Use the application gThumb to
- crop image to ratio, eg 3:1,1:1, 3:2, etc. and accept, than
- resize to image width 1200, 800, 300, etc. and accept and
- finally save as with appropiate name extenstion like header, large, small, teaser.
Than link the images ![Simon]({{"/assets/images/cat_simon_small.jpg"}})
in the
post with markdown syntax followed by image alignment instructions
{: .full}
{: .align-left}
{: .align-right}
which results in
![Simon]({{"/assets/images/cat_simon_small.jpg"}}){: .align-right}
To locally preview and check the changes start the terminal Tilix, do
$ bundle exec jekyll serve
and than view in the browser at http://localhost:4000
For a general understanding of git and GitHub read Hello World Guide.
First sync the fork
$ git fetch upstream
$ git checkout master
$ git merge upstream/master
To commit start a second terminal tab and do
$ git log # see the last commits
$ git status # see the staging area
$ git add . # mark files to be commited
$ git commit -m "create a blog post about live"
If you forgot something, or want to change stuff in the last commit, do
$ git add . # mark changed files to becommited
$ git commit --amend # append changes to last commit
than push to GitHub, which also will deploy changes to the server:
$ git push
A successful git push
will trigger a GitHub webhook and deploy the static
site to Netlify. Than "it is live" and before promoting via email to
friends and family check the results at https://www.lolasview.com
For further help and advanced customisations read about
Check out the Jekyll docs for general info on how to use Jekyll.
The following directories and their contents are copyright of L0laB. You may not reuse anything therein without my explicit permission:
- _posts/
- assets/
Everything else is free software, and may be redistributed under the terms specified in the LICENSE file.