npm install -g gatsby-cli gatsby new my-website https://github.com/orgapp/gatsby-starter-blorg
It's one command away from getting it running locally. You will have a powerful website sitting on localhost:8000 afterwards. Which conveniently, also is a complete documentation of the tool.
cd gatsby-site # if you haven't already npm run develop
What's in the Box
You get all the benefits from gatsbyjs, the flagship tool for creating modern websites. It will net a pretty good score on Google's website evaluation tests.
Here is a list of the important (in my opinion) features you get right away.
Optimised for SEO
You get detailed metadata for every page. They came from your org file itself (properties, tags, description etc...). Open up inspector of this page, and you will see something like this:
Some of them will help boost your website visibility on the internet. The Twitter ones will make your pages look amazing when shared on Twitter.
Over time, more people will be reading your words on their tiny smartphone screens instead of a glorious 4K display like yours. Resize the window to see how it transforms into a different layout gracefully.
Progressive Web App (PWA)
I don't need my website to be as sophisticated as an
app, but it is nice to add additional resistance to a bad network to it. Your website will pre-fetch content and cache it in the browser like an app. So the whole website works 100% even when your device is offline. Also clicking an internal link feels like pressing a button on an app.
Colour is a personal thing. The point is, you can customise every single detail about them, and you get two sets of them.
Every bit of the website is customisable. From the header to footer, from the post layout to the date and tags. If you'd like, you can nuke everything and build them from scratch.
Designed with org-mode user in mind
In some sense, org-mode is similar to markdown. But it's so much more flexible. So people use it in all kinds of ways. The following features are tailored particularly for org-mode users.
What's the Catch
- It is react based, so if you want to go deep in the customisation game, you going to have to be comfortable with copy & pasting, maybe tweaking some