To test on local: bundle exec jekyll serve
To test with drafts published: bundle exec jekyll serve --drafts
It took a bit of work to get ruby, bundle and jekyll stuff set up on the local machine. I don't recall all the tweaks I had to make, hopefully it goes smoother the next time I have to install.
To add a new blog entry, create it in the _drafts
folder first.
Images. To include an image, put it also in the same folder and reference it with the following pattern: '\drafting\image[(<arg>=<value>),*]{<alt-text>}
. The syntax comes from a homemade template language I've not finished working on. Arguments include:
source
: (required) The name of the file relative to _drafts.size
: A size to resize the image to. Values includeA5
-A10
based on the standard paper sizes with those names with a dots per cm of 59, or<integer>x<integer>
in pixels.format
: The format to resize the image to. Values includel
,p
,landscape
, orportrait
.watermark
: Whether to place a watermark on the image. Values includetrue
orfalse
.full-link
: Whether to turn the image into a thumbnail link to a full version of the image. The thumbnail will be size A6 or A7 depending on the format of the converted image. Values includetrue
orfalse
.
NOTE: Some changes were made since the last publish attempt regarding the images, and the script might not work until they are tested.
Publishing. To finally publish it:
- Run
_tools/publish.rs
(requires rust-script). The script will prompt you for which post you wish to publish, and run through a checklist of things to make sure you caught everything. - Make sure the website builds.
- Push the changes to GitHub.
Modified files will be placed in the _posts and _assets folders as necessary, and the originals will be given a .published
extension.