site sections

zines and other literature

route: /catalogue

• free offline copies of zines, books, web articles, and pretty much anything else that a browser can handle
• displayed in a familiar format
• encourages supporting the authors by prominently displaying source links
• tags feature is being planned!

data/lib/catalogue.yml example:

- title: The Content Piece's Title
  author: Author Name
  description: >
    You can use a pipe | or a greater-than symbol > to write YAML strings across multiple lines.
    See https://yaml-multiline.info for details.    
  type: zine | book | article | ...or whatever you want
  tags:
    - foo
    - bar
  image: "/static/lit/file.jpg"
  image_class: banner | portrait
  href: "/static/lit/file.pdf"  # the primary link that the image/title anchor points to
  links:  # extra links off to the side
    epub: "/static/lit/file.epub"
    source: https://zine.website/

links to cool things on the web

route: /hyperlinks

data/lib/hyperlinks.yml example:

- name: Section title
  description: This is a group of links under a related banner.
  links:
    - url: https://website.org/page.htm
    - url: https://example.com
      name: Super duper cool website

- name: Group two
  description: This is another group of links!
  links:
    - ...

configuration

copy example.config.yml to config.yml in the same location as the xanadu executable and make changes as needed.

design

• tiny web, maximizing browser compatibility by being smol
• mobile and desktop equally important
• ascii art wrapped in <pre/> tags with alt-text for accessibility

name meaning

a reference to:

• Project Xanadu (also referenced in SEL)
• X.A.N.A. from Code Lyoko, which references [Citizen Kane](https://en.wikipedia.org/wiki/Xanadu_(Citizen_Kane), which references Kubla Khan.
• "Xanadu" is a (pretty bad) transliteration of Shangdu, a capital city of the Yuan Dynasty in medieval China. blame Samuel Taylor Coleridge for that spelling.