Author's update from summer 2022: most of these articles were written some seven years ago. The web has changed a lot since then. Enjoy!
This is the repository of the book on web development I’m writing. It contains my drafts as well as finished articles, design ideas, personal notes.
☞ Please read the Introduction to Codes & Notes
Having used Jekyll, Wordpress, Middleman, my own Gulp generator I've finally settled on Hugo + Gulp to build the book. It's a static site generator written in Go. Super fast (really) and very flexible.
All articles are in the content folder. They are written in Markdown format with YAML front-matter. Templates, styles and scripts are in the app folder.
You will need Git, Node and Hugo installed on your system. Then go:
git clone git@github.com:oskarrough/codesandnotes.gitcd codesandnotesyarn
To start a local development server: yarn start
To deploy the project, push to the production branch. This will trigger Netlify to build and publish to https://www.codesandnotes.com.
Both Alex and retext-mapbox-standard can be used to check the writing. Take these suggestions with a grain of salt.
yarn test