Sun, Oct 4, 2020

Following the tutorial

Almost all of the introduction is in youtube videos.
The folders and config files all have underscores.
The post names all need to have a specific format with year, month and day at the beginning. This probably not a terrible organization strategy…
But without the year, month, and date your post just doesn’t show up. You could be editing your post, refreshing the page and just not know why. There was no error message, just a missing post.
Adding and editing posts requires a browser reload, which I find tedious.
Ah, upgrade to 3.7 and you have a –livereload option

Ubuntu install

sudo apt-get install ruby-full build-essential zlib1g-dev

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

gem install jekyll bundler

jekyll new jekyll-test
cd jekyll-test
jekyll serve --livereload

Troubleshooting

I had previously tried to install jekyll from the repository with sudo apt-get install jekyll. That seems to break the above steps, to fix that I did a sudo apt-get autoremove jekyll, then gem install jekyll bundler again.

File structure

/_posts/**/YYYY-MM-DD-post-name.md
/_config.yml
/page.md
/Gemfile

Creating content

Adding Assets
Create an assets folder at the root
Unfortunately the assets have to be outside the _posts folder. This means you have to switch back and forth between the posts and assets folders.
Image links will probably get long quickly. I would mirror the structure for posts folder in assets, so for each post I would create a folder with the same name and put all the assets for that post in there. This means the include line for the post 2020-09-23-jekyll-details.md would be ![TestScreenshot](/assets/2020-09-23-jekyll-details/test_image.png). I would rather not have to put the full path in each time.

Markdown Format

Themes

The theme list can be found at (jekyllrb)[https://jekyllrb.com/resources/]

Installing a new theme requires you to download the new theme, then copy your content over. This is problematic for several reasons:

If you’re not careful you will loose your git history
You could accidentally delete all your content if your not careful, but thank goodness you’re using git.

As usual make sure you have a backup of your repository before you start. The theme I’m going to use is: https://github.com/volny/creative-theme-jekyll.git The suggestion on their page was to add it as a gem dependency, however that didn’t work with the default template.

The next step was to download their repo as a starting point and copy my repository over and my content over.

My theme directory is: jekyll-test I’m starting in the containing folder for jekyll-test.

git clone –depth 1 https://github.com/daviddarnes/alembic.git jekyll-test-new rm -rf jekyll-test-new/.git rm -rf jekyll-test-new/_posts cp -a jekyll-test/.git jekyll-test-new/ cp -a jekyll-test/_posts jekyll-test-new/ mv jekyll-test jekyll-test.bak mv jekyll-test-new jekyll-test

Jekyll Review