From c9bdf4dbd10176365de63a0b0bb1eff3b7e36c3f Mon Sep 17 00:00:00 2001 From: Oliver Davies Date: Thu, 17 Oct 2019 21:45:25 +0100 Subject: [PATCH] WIP add dev page --- source/dev.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 source/dev.md diff --git a/source/dev.md b/source/dev.md new file mode 100644 index 00000000..65206977 --- /dev/null +++ b/source/dev.md @@ -0,0 +1,23 @@ +--- +layout: page +title: Developing this Website (WIP) +--- +This site is built with [Sculpin][], a static site generator written in PHP, that generates a static HTML website from Markdown files and Twig templates. You can see the [source code on GitHub]. + +## Extending Sculpin + +- Custom Twig extensions +- https://github.com/opdavies/sculpin-twig-markdown-bundle +- https://github.com/opdavies/sculpin-gist-embed-bundle +- https://github.com/opdavies/sculpin-content-generator-bundle + +## Front End + +On the front-end, I have used [PostCSS][] rather than Sass or Less, and [Tailwind CSS] for all of the styling, and some [Vue.js][] for the navbar and toggling the navigation menu on mobile. These are compiled with [Webpack Encore][] - a wrapper around Webpack, provided by Symfony. + +[PostCSS]: https://postcss.org +[Sculpin]: https://sculpin.io +[source code on GitHub]: https://github.com/opdavies/oliverdavies.uk +[Tailwind CSS]: https://tailwindcss.com +[Vue.js]: https://vuejs.org +[Webpack Encore]: https://github.com/symfony/webpack-encore