Aug 25, 2020
This website exists to publish my journey of learning how to code and making Routernote, software that will help me stay organized at work. My goal was to use the process of building the website to learn things I would need to know anyway to make Routernote. I'm making Routernote with Angular, open source software for making web apps. I figured as long as I'm learning Angular I might as well use it for the website too, even though it is a bit overkill.
Why overkill? It takes a lot of complicated stuff to build and run a web app, because the internet was originally static views that did not change much, but applications have to update the view all the time. The internet today runs with 3 programming languages:
If I wasn't familiar with Angular already, I would have gone a different route since Angular has a steep learning curve and was not designed for blogs and personal websites. For a non-commercial site with minimal coding required, I might go with WordPress since it has a huge community and lots of support online. I would use the free version of WordPress and follow their hosting advice. Be aware that it suffers from security issues, so you really have to stay on top of the latest patches for WordPress itself as well as all the plugins you inevitably will install. Squarespace is really nice for a site that you are planning to make money on, but hard to justify the price otherwise. If I was willing to get more into the code, I would use a static site generator such as Hugo that does not require Angular to use.
One nice feature that Scully has (as does Hugo and most SSGs) is that it can be configured to automatically convert Markdown files to HTML and put them wherever you want on your site. Markdown is a very simple syntax for writing on the web. John Gruber, the creater of Markdown, has a nice write-up on the goals, philosophy, and syntax of Markdown on his website Daring Fireball. Markdown is extremely easy to learn, and completely readable on its own without being converted to HTML or a PDF. It is perfect for writing blog posts.
The best resource I've found for using Scully and publishing your website is by far Tara Manicsic's Netlify Blog. She has been posting about this since late 2019 when the first version of Scully was released, and has numerous articles with step by step instructions for getting a blog up on the web. I would recommend reading all of her Angular-Jamstack-Scully related posts.
Another site I found helpful was Corbin Crutchley's post on manually adding Scully's blog support rather than having it automatically generated. It really helps to understand what's going on under the hood, since you will probably want to customize something sooner rather than later!
The last site I will mention right now is a post on inDepth.dev by Stepan Suvorov: How to migrate WordPress to Scully. He goes into detail on ordering blog posts by date (I used his code!), adding tags and search (I plan to use his code!) and more. It went beyond what was already on the web and was very helpful to me.
With this intro out of the way, my next posts will detail how I got this site up and running given the links above as a baseline. My goal is to write the articles I wish I had found when I was searching.