Skip to content

lunatech-labs/lunatech-blog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

lunatech-blog

Contains our blog in Asciidoctor format.

Each post is located in the posts directory with the following format: yyyy-MM-dd-title.adoc

In the media directory there should be a matching image named yyyy-MM-dd-title/background.png

All media used in the posts should be located in the media directory under a yyyy-MM-dd-title directory ie media/yyy-MM-dd-title

To add you blog post:

  • Install giter8, via coursier
brew install coursier/formulas/coursier
cs install giter8
  • Fork this repo
  • Checkout the forked repo
  • In the repo directory g8 file://.
  • Write your blog post
  • Submit a pull request and follow the template

Information regarding giter8

If you see this error :

Error: giter8 has been disabled because it fetches unversioned dependencies at runtime!

Then you can bypass the warning message by doing the following:

brew edit giter8

and delete this line:

disable! because: "fetches unversioned dependencies at runtime"

then run brew install giter8 again.

Provide compressed images

Every blogpost has at least one image which makes the Lunatech blog relatively heavy in memory consumption. One way of to combat this is by compressing images using pngcrush. You can install it using brew:

brew install pngcrush

You can then create a compressed version of each image (png/jpeg/gif) you are submitting alongside your blogpost:

pngcrush -rem allb -brute -reduce in.png out.png

For very large images the command may take a long time to complete.

How to deploy your post

Merging your PR will update the main branch only. In order to share your blog post with the world, you'll need to deploy it first in Acceptance, and then in Production.

You can do both with the help of GitHub Actions:

For the time being, the blog engine needs to be manually restarted in clever cloud as well. Please ask your colleagues if you don't know how to do that.