Site creation & plans

( * ^ *) ノシ 1 min. read

This page will serve both as my notes so I remember how to update this site, and guide me to recreating the environment require when my hard drive probably dies ;;

Much of the documentation to serve this purpose will be within the source file for this page as comments or practical examples.

Goals

  1. I enjoy creating it. Whimsical :]
  2. Provide an easy way to create blog posts.
  3. Demonstrate the use of static sites[1] for compatability with older hardware (I want it to run on like a DS or Wii).

Getting started

I am using visual studio code for editing this site's source files, (markdown files) which 11ty translates to html/css code

Install npm

apt get install npm

Then

npm install @11ty/eleventy
npm install @11ty/elevenety-plugin-syntaxhighlight

A very useful feature is

npx @11ty/eleventy --serve

Which creates a live updating web server @ localhost:8080

To upload the website to neocities we can use neocities CLI

neocities push .

Future goals

1. Better LaTex integration

This site currently uses MathML for rendering math equations, but this is very unweildy to use, (practically speaking you want to just copy it from libreoffice)

I want to eliminate this set as having integrated math is really nice.

  1. A static site is just a site that minimise use of things like javascript, essentially doing compiletime generation as opposed to runtime generation. ↩︎

CC BY-NC-SA | Zoey K. 2024.