Meet Jekyll - The Static Site Generator

[@TechnoTim]

Have you built your own website yet? Do you self host it?

[@wyattarich]

Why did you not go with Hugo?

[@WanderTrekker]

For all Jekyll stuff I use vercel

[@gaston-alegre-stotzer]

(S. Connery voice) Yeeessshhh! Self hosted hugo+nginx+docker+portainer+rasperrypi4

[@latlov]

I will try it with Docker on self hosting. I will have to find out the process of uploading new content to the blog

[@mistakek]

I've been using bookstack in docker for all my homelab docs stuff, but I do like your doc site so I'll fumble through this and see how I go, but I have very little knowledge on coding. It's on my list of things to learn. Should be fun :D

[@michaelol]

This is amazing, I literally use this for creating a locally hosted site that does have a small login screen before you can get into it with a password that I only know. It holds so many of my notes for programming and also assist me with IT Related solutions. I've been working on it for about 4 months now and its all thanks to this video.

[@arthgupta]

My god man, what an incredible pitch for a static site generator in the first minute and half!

[@iflux8821]

Well done, sir! I wish KZbin showed me your video first without going through tons of unwatchable stuff. Subscribed in 15 seconds 😆

[@Mtbred]

Yes! I swear it's like Tim reads my mind half the time with the videos he chooses to publish next

[@Impish4825]

Our minds

[@Nemesislh]

Dude I've been checking out self hosted notes taking apps for the last week for self documentation. Godsend

[@Stevenwaupevon]

Totally agree it's his weird super power

[@ibullard]

Agreed. I was literally looking over the mess that's my Google Spreadsheet document the day before this came out, trying to figure out how the hell I was going to make it work.

[@barefooter2222]

Came here to say this! My favorite homelab KZbinr by far

[@VioletGiraffe]

I _almost_ feel like a web dev now! Thanks, Tim!

[@TechnoTim]

Thank you!

[@prashkd7684]

I followed these steps but for some reason my github actions keeps failing to deploy it on GITHUB even though its working okay on my local machine. Anyone else having this issue ?

[@iflux8821]

Still failing? Just post a link to your repo so we can see the error message

[@leonardopinero-perez9347]

Just got through this, you need the assets/lib submodule on the chirpy repo. After that, you need to set "use submodules : true" (commented out by default) on the repo's deploy.yml file. Hope this helps!

[@hananiahlinde1377]

This is amazing. I’ve always wanted to get into blogging but I’ve always felt the barrier to learning Wordpress or some other cms tool/platform was too high. As a developer, this is the perfect solution. Thanks for the awesome video!

[@NiceDevil]

Would be kind to see a guide on how to run/deploy this site on a local environment like a LXC without the github pages part. In this case we can run it behind a reverse proxy or even just localy for local documentations. Anyways, good guide as always :)

[@MaxKulik]

Seeing the section about a CDN got me to thinking. I personally have my own CDN using a combination of Backblaze and Cloudflare. It's pretty much free.* I could not imagine a standard home lab racking up a massive cost with how cheap Backblaze bucket storage is. So Tim, do you use a CDN and if so, it would be cool to see a video on this topic. If you have any questions about how The Backblaze and Cloudflare combo work I would be more than happy to offer some pointers!

[@CliffR]

Haven’t found a video you released that wasn’t interesting. Great stuff

[@TechnoTim]

Thank you!!!

[@bharateeshdiggavi8754]

Hey I followed the exact steps, when I push my changes, github actions run fine as well. But I don't see gh-pages branch in settings→pages. Am I missing anything here?

[@write2santosh7606]

i tried by making my own gh-pages branch.

[@itskagiso]

Great tutorial.... I'll be implementing this. Could you have a tutorial on Kubernetes deployments - I still struggle with how to deploy and then expose services especially incorporating those services with nginx and cloud flare on my domain

[@OrganicBricks]

How do i do this on my mac? im stuck on 4:54

[@berru1162]

@TechnoTim I am sending the .md file as a post, but it doesn't appear on my website. How can I fix this situation? Also, video is very useful, thank you!

[@lewiswesley66]

same issue here.

[@AlwaysEast]

Posts need to be named `year-month-day-.md`

[@aram4017]

@@AlwaysEast Thank you!

[@latedeveloper7836]

Thanks for this - trying to follow along but the 'bundle' command does not work on Windows in command prompt or powershell when in the project repo - what am I missing? Thanks

[@augystudio]

You remind me of Johnny Depp a lot. Thank you for helping me start out with Jekyll! I already was hosting on github pages but somehow i didn't try jekyll and was coding html and css, but all my pages had extension .html 😅

[@AlexeiAnisimov]

Awesome tutorial brother thanks mate 🤝

[@onehumanwasted4228]

what did you do in 4:56 ? You just typed the name of the cloned folder and you started git with that. Does not work on my (Linux) machine..

[@TechnoTim]

Check the docs, all commands are there!

[@onehumanwasted4228]

@@TechnoTim I entered the same command (the name of the folder of the git repository) even in the same enviroment (looks like youre running WSL in Windows Terminal) but I get "command not found " error instead of your fancy "git(main): " input

[@antonio638]

You are insane! I have learn so much by watching your vids, thank you so much! Congrats on almost hitting 100k

[@TechnoTim]

Thank you!!!

[@l0gic23]

100k hit 1 day later... Way to go tim

[@maxydoodles3461]

Having trouble uploading an avatar when I've added the photo locally. Any suggestions?

[@berru1162]

Hi, I uploaded the photo I wanted to use as an avatar to my pinterest account as a pin, then took the url of the photo and pasted it into "avatar:".

[@DaCooKyBandit]

I really would like to know if there is an extension in VS Code that you are using that pulled up the list of timezones as you were typing yours out in the config.yml file. It even auto correct your spelling mistake by the end. If so, what is that extension? Would love to be able to use that!

[@bulldogg4]

This video was fantastic, thank you for replying to the comment I left on one of your other videos asking about this documentation site. It was a little rocky for me to get things going at first as I'm a networking guy not a web/dev guy but I think I've got a handle on how everything is working now thanks to this tutorial. Now its off to figure out the custom self hosted docker container video you mentioned at the end of this video.

[@TechnoTim]

Thank you! I have a video in creating a custom docker image! Build YOUR OWN Dockerfile, Image, and Container - Docker Tutorial kzbin.info/www/bejne/iZ-2eWt-qZiAf8U

[@RedBugBoy]

github didn't generate gh-pages for some reason ..

[@AlwaysEast]

Same.

[@TanukiSack]

​@@AlwaysEast same. GitHub Pages is publishing my index.html file and not config.yml. It works local though.

[@packetouille3781]

Great video! For whatever reason, in the Settings -> Pages I'm not getting the gh-pages branch. The only options for me to select are main and none... Not sure what step I'm missing. I've deleted the repo and started over twice already to see if there's something that I've missed and ended up with the same issue. Any ideas? I'm using Windows 11.

[@packetouille3781]

I'm getting the following. Perhaps a dependency is not installing? I'm using Windows. continuous-delivery Error: The process '/opt/hostedtoolcache/Ruby/2.7.6/x64/bin/bundle' failed with exit code 16 at ExecState._setResult (/home/runner/work/_actions/ruby/setup-ruby/v1/dist/index.js:6023:25) at ExecState.CheckComplete (/home/runner/work/_actions/ruby/setup-ruby/v1/dist/index.js:6006:18) at ChildProcess. (/home/runner/work/_actions/ruby/setup-ruby/v1/dist/index.js:5900:27) at ChildProcess.emit (node:events:390:28) at maybeClose (node:internal/child_process:1064:16) at Process.ChildProcess._handle.onexit (node:internal/child_process:301:5)

[@packetouille3781]

UPDATE: After digging into it, the issue was within the setup of continuous delivery. Specifically the Ruby setup. I was receiving a message stating "Your bundle only supports platforms ["x64-mingw-ucrt"] but your local platform is x86_64-linux." with instructions on how to add the current platform to the lockfile. All clear after I ran that command. In case anyone runs into a similar problem.

[@bachhoang9004]

@@packetouille3781 can you be more specific ? i'm getting this problem too

[@packetouille3781]

@@bachhoang9004 Do you have all of the dependencies installed? Confirm with ruby -v gem -v gcc -v g++ -v make -v If you're receiving the same message that I was: "your bundle only supports platforms...." under Actions -> [your commit that failed] -> continuous-delivery -> Setup Ruby -> bundle install, which is right before where the error occurred for me, then you should see the following: "Your bundle only supports platforms ["x64-mingw-ucrt"] but your local platform is x86_64-linux. Add the current platform to the lockfile with `bundle lock --add-platform x86_64-linux` and try again." After running that command, it worked for me. I hope this helps.

[@fredericoeusebio2494]

This is going to look awesome on my CV.

[@azmyin]

Hi Mr. TIm, what is the theme you are using?

[@G-3-A-R-Z]

So great, I actually love Jekyll just a month later. I needed a new portfolio site that was easy to maintain, and it works great on docker.

[@AlwaysEast]

When I commit and pushed through github desktop, the post was visible on my site but nothing appeared in category or tags. It did however when I pushed and commit through the terminal in VS code. Just thought I'd mention this since there was nothing about it in your docs. Cheers for the guide, Tim.

[@OARomanov]

This. Is. Freaking. Awesome. Hey Tim you just made my day. Thank you for this!

[@thegittubaba]

Jekyll in 2022? Might I ask why choose this over hugo?

[@TechnoTim]

It’s not an “or”. It’s an “and”. I use both along with others!

[@traxeonic3600]

@@TechnoTim I can see this being a content piece... "so in a previous video, i showed you how to use Jekyll and a lot of people asked why not Hugo. Well, I use Hugo as well, and in this video, I will show you how to use Hugo to . It's very similar to ".... ;)

[@조인환-s7k]

This is awesome. but I have a problem on last section. I can not find 'gh-pages' in Pages of Setting menu. so after few minutes my page shows "--- layout: home # Index page --- "

[@KratomSyndicate]

issue is the base url has to be baseurl: ''

[@lozzax98]

Did you ever fix this? I have the same issue, tried the baseurl: "" but it's still only showing the layout: home page

[@duncan-mcrae]

Awesome. I legitimately have a use for this. You've made my life easier.

[@MyAeroMove]

Have just created my Hugo blog couple days ago 😀

[@TechnoTim]

That's awesome!

[@veilsec2667]

my pages not shown in categories

[@biplabdutta]

Hello Tim. Thanks for the video. I am running Jekyll on a container and the problem I am facing is not being able to perform live-reload. I always need to stop and restart the container to view the changes. I am using volumes too. I have tried everything but none seems to work.

[@TechnoTim]

I haven't run this in a container while developing, only after when it's in prod

[@biplabdutta]

@@TechnoTim Would you mind creating a video on chirpy theme + Docker 😅 (using jekyll image from docker hub)

[@MobiusSeckOne]

What do you use to make your diagrams? I kinda bored of using DIA...

[@TechnoTim]

either diagrams or lucidchart!

[@MobiusSeckOne]

@@TechnoTim oh thanks, diagrams looks neat!

[@kjakobsen]

Wonder if Markdown has a syntax highligning for networking CLI commands (Cisco, Fortinet, Juniper)

[@hembromjohn]

I already have a domain with route 53, Can I host this jekyll site with S3 & amplify? Please suggest

[@muhammadnajmuddinfarid9567]

I wonder if is it actually possible to make the repo private but host the site publicly?

[@hiteshlade453]

Can we change Background of website with image?

[@tegster]

Dude your videos are amazing, your presentation skills are next level.

[@abepeterson]

I am confused right from the start, you started typing sudo apt get requests into what terminal? I rewatched this video many times but I do not see where you mentioned this at all? Where are you installing to?

[@Mochikun808]

I'm not seeing gh-pages, but it seems to be working and I do see it being hosted on github. Is it ok to leave the page branch set to main?

[@KrazyMO]

Is the markdown in Jekyll similar or the same as obsidian notes?

[@TechnoTim]

Markdown is a universal language, so yes!

[@VmMW96]

Thanks for the video! I also hosted jekyll with chirpy, but since 3 days my layout looks broken. I checked your site and it seems broken as well. Is it just my browser or is something else going on?

[@TechnoTim]

Funny, this is actually a pihole rule that broke a CDN. Update your pihole rules and refresh!

[@VmMW96]

@@TechnoTim Thanks a lot! I didn't do anything and it worked again. But tbh I don't really understand the reason behind it. My pihole has no blocked querries from the jekyll host

[@agkbeatz]

5:18 what is this console?

[@traxeonic3600]

On Ubuntu 22 (jammy) LTS ARM64 (running in Parallels on M1), I had to install ruby-bundler. For whatever reason ruby-full did not install it. Just a heads up. I think it was skipped over in the video, but does show the gem way to do that in the documentation.

[@traxeonic3600]

@@emeraldbonsai The issue was actually a missing step in the video that is in the documentation. Also, when I push to github, the action fails for me. So now I have to go do a bit of debugging....

[@traxeonic3600]

Definitely is not working. The github action keeps failing after push. Local site is fine, but the automatic build keeps failing. If you are not building and browsing locally, this lets you browse from a remote machine: bundle exec jekyll s -H `hostname -I | awk '{print $1}'`

[@ramane2900]

@@traxeonic3600 This made it work for me. bundle lock --add-platform x86_64-linux

[@RanaMuhammadWaqas]

you never explained why gh-pages branch? In the whole video you never told that you need to make this brnach as well

[@binnihh]

Why not have an url to Jekyll in the video description?

[@TechnoTim]

Good idea! It’s in the docs!

[@nickswebtsv]

Somehow my posts aren't appearing when I'm creating a post. Have created my post exactly as yours was in the video but when I got to Chirpy in the web browser or even the generated "_site' folder there's no post appearing. Have tried restarting the jeklyll instance, i.e, re-runing 'bundle exec jekyll serve'. I'm not sure what's gone wrong. Any pointers?

[@TechnoTim]

Be sure to format the name according to the date! See the docs for examples!

[@nickswebtsv]

@@TechnoTim Thanks yea, I found that was the problem!

[@yankunbigcat7925]

Thank you so much for this awesome video! The theme you used is exactly what I'm looking for, and the tutorial is helpful as well!

[@TechnoTim]

Thank you!

[@jonnypeace2810]

This is awesome. Will definitely be looking into this 🙂

[@TechnoTim]

Hope you like it!

[@Dan-ug7zc]

wish we have microcenter here

[@rakash4118]

If I leave the theme_mode: empty I'm not able to change it by clicking the button. It only detects the system theme. Can anyone help?

[@CrossingWolfi]

After two hours of fighting with bundler and gem on MacOS I am discouraged of using anything Ruby related ever again. :( I just want a very basic website but making Jekyll work seems to be harder than learning html.

[@LimitlesslyUnlimited]

Hi Tim, This was an amazing tutorial; thanks for all that you do! Loved it and just got setup. Learnt so much from your video today.

[@TechnoTim]

Great to hear!

[@devr.singhania2424]

why aren't the posts, that i create showing up on the website?

[@007KrausBean]

Mine were not showing up either. Then I rewatched this and found that he made a change around the 14:18 mark and never mentioned a single thing about it. Notice that he names the post file 'hello-homelab.md', but when showing the git commit stuff it has the date in front of it. I went back to my file and renamed it to have the date in front of it and all of the sudden it appeared. Maybe this is something that recently changed with this starter, but I doubt it as it is happening in this video but no mention was made. Hope this helps you.

[@rmbdev218]

Pass the --livereload option to serve to automatically refresh the page with each change you make to the source files: bundle exec jekyll serve --livereload

[@The_Waraba]

What's the "-500" in the date of the blog post ? You've written "2022-05-23 12:00:00 -500"

[@TechnoTim]

UTC offset!

[@The_Waraba]

@@TechnoTim Ah okay, so based on the time zone I’m guessing

[@The_Waraba]

@@TechnoTim It looks like Chirpy or Jeykill that doesn't take daylight savings by default. How to configure that ?

[@zer0pwninit]

jekyll theme is not found

[@frankterry8896]

im making edits and posts, but when i commit and push the site isnt being updated?

[@TechnoTim]

GitHub caches heavily. It might take up to 10 min for them to flush their cache! Keep refreshing!

[@Mikesco3]

Man I finally got this working... But what a pain in the @##!! the yaml header and the markdown for each post are really finicky, it took me for ever to get a first post working.

[@lewiswesley66]

what worked?

[@mojex]

How can I make the Chirpy theme multilingual so that the visitor can click on a link and see all the layouts and post changes in another language?

[@TechnoTim]

I would check their site, if not use a plugin for jekyll

[@ardenswirl7361]

Can you write a wiki or post a video for how to host it on Cloudflare pages please and a video for Hexo and other similar Static site generators Please

[@kirksteinklauber260]

Great video! Can Jekyll publish Word documents? I try to keep my lab documentation on word but it will be great to have an open source and self hosted solution that can publish word documents into a web page in a blog or portal with some indexing structure. If Jekyll doesn't have this capability do you know any other potential solution? Thanks!

[@TechnoTim]

Not that I am aware of, sounds like you are looking for a SharePoint alternative or LibreOffice like system. Look at Nextcloud

[@kirksteinklauber260]

@@TechnoTim thanks!! Will check it out

[@bpetrikovics]

Exactly when I'm fiddling with the same thing :) Thanks, this helped a bunch.

[@markstanchin1692]

Oh boy I'm struggling with this now. I lost my proxmox boot satadom and I have to start all over again because of lack of notes ect.

[@pabloescobar9337]

Can you do file flows next? Looks like a better version of Tdarr that's completely FOSS.

[@l0gic23]

Tdarr is not FOSS? Woops, I just told someone it was -- should have checked. Woops

[@house0795]

Can you make video about searxng- self search engine?

[@bakeery]

Am getting Conversation Error Jekyll::: Converters ::Scss encounterer an error while converting assets/css/jekyll-theme-chirpy.scss how should I go about it pl, i need help

[@zaza-ik5ws]

When did Johnny Depp get into web dev?

[@AbhijeetMishra-bl7yr]

@TechnoTim my build is failing please help I am able to see the changes in local.

[@AbhijeetMishra-bl7yr]

Create Pages site failed build AxiosError: Request failed with status code 403 build Get Pages site failed

[@oneoneoneman]

17:20 now getting upload error: continuous-delivery Error: The process '/opt/hostedtoolcache/Ruby/2.7.6/x64/bin/bundle' failed with exit code 16 PS this happens because he uses linux, if you are on windows you'll be stuck. in order to solve this, run locally: bundle lock --add-platform x86_64-linux I wasted 2 hours to find the workaround hence not so straightforward

[@brendongong7295]

Homie

[@oneoneoneman]

@@brendongong7295 😏

[@EmadSaeed]

Thanks Tim, nice video

[@TechnoTim]

Thanks 👍

[@propeto13]

i want to run this static site on my unraid box. send help!

[@TechnoTim]

Check the docs on how to build a docker container!

[@SorinOltean77]

Just wanted to say: Jeff Geerling sent me here.

[@hamzaverde6385]

ty bro the video is helpful but i have a quastiion how can i share post after hosting the blog into github please i need assiste

[@TechnoTim]

Each blog post should show sharing buttons at the bottom!

[@hamzaverde6385]

if i wanna create a file md in posts folder it's not apear pls can u help me @@TechnoTim

[@MahdiHaeri]

awesome💯💯

[@alfredodhiambo8657]

Followed the exact steps on creating the markdown post in the _post folder but when I refresh the page, the site is empty. Anyone experiencing the same problem

[@alfredodhiambo8657]

Got the solution, the .md posts under the _posts folder should be named starting with the YYYY-MM-DD specified on your post's year, month and date.

[@nayeemislam574]

Followed every steps but my post is not displaying. Can anyone help?

[@AlwaysEast]

Posts need to be named `year-month-day-.md`

[@widepootis]

thanks a lot for this clear and concise video, you're also very agreeable, which makes the video even better

[@TechnoTim]

Glad it was helpful!

[@Jack-eu2yh]

Anyone know how to change the favicon ?

[@fredericoeusebio2494]

Hey Techno how do I restart the server in case of the website doesn't update?

[@TechnoTim]

Control + c then start it again!

[@lakshminarasimmanv]

This is nice but I like Hugo

[@andresklai]

Create my own custom docker container to host my own documentation site????!!!!! Sounds like homework to me and I've never been more psyched to do it.

[@DuMusic00]

What did you open for code .and bundle

[@TechnoTim]

windows terminal

[@GravyyTrain]

You never metioned that this installation requires Ruby be installed on your machine. it would save a lot of headache for a lot of people

[@TechnoTim]

Thank you and sorry!

[@mza9738]

I would recommend Hugo instead of Jekyll. It has also many themes in its marketplace.

[@llothar68]

Ruby is much better when you have to hack your own plugins and you will

[@JeanFrancoisPelgrims]

Hi :) Thx for the video, this is what I was looking for. Unfortunately I ran into an issue. After created my first page and reloaded the server, my page doesn't render. I tried to create a second page and same issue. I'm still looking how to resolve that :)

[@TechnoTim]

Check the docs on my site for the page name formatting!

[@JeanFrancoisPelgrims]

@@TechnoTim I'm feeling like I'm an idiot :P

[@TechnoTim]

@@JeanFrancoisPelgrims all good! I messed this up too!

[@JohnWeland]

NOICE! I wonder how to break this out so like if I had a repo for a project all of this would like in a folder 'docs' and the project code lives in maybe 'source' or 'code' and when you push domain.tld points to the project and docs.domain.tld points to the docs. (all from the same repo). I am struggling with project specific docs.

[@zariffathurrahman6454]

im really going to ask you about how u build your website. and here you are. thank you so much !!

[@evertythingtechrelated9715]

Nice video, You should do a video on Authentik next.

[@TechnoTim]

Thank you!

[@DerLuukee]

Was this just a 3.24 min intro ad?

[@TechnoTim]

No, only 30 sec ad, the rest was explaining what jekyll is

[@lechaldon]

Nice. I built mine with mkdocs

[@MaxKulik]

Get out if my home lab needs!

[@2u841r]

10:40 I am laughing 😀 form Bangladesh

[@SvenMazet1973]

Tnx for the tutorial, I'll be looking into this one soonish... have a Bookstack for my homelab stuff, but I'm not "feeling" that system. Also using Ghost as a blog... maybe time to combine both into one homelab site...

[@DapperDuff]

Light mode... Also known as Flash-bang mode.

[@uuu12343]

Thank you so much! Been trying to make my portfolio website from scratch LMAO