SER documentation

From XPUB & Lens-Based wiki

INTRO

This is the documentation page for building the SER with paged.js

This page was born in 2025 and written by Chrissy, Tessa and Kiara.

Tools

  • Microsoft Word
  • The XPUB git
  • paged.js (including HTML and CSS)

Git Cheatsheet

PULL

git pull [ssh]

PUSH (Shortcut)

git commit -a -m "hello"
git push -u origin main

PUSH (long version)

git add [name of the file/folder - to repeat for everything you modified]
git commit -m "hello"
git push -u origin main

TO OVERWRITE FILES

git fetch
git reset —hard HEAD
git merge origin/main

Workflow

The content of the document is lying in a .docx file written by the 3 course coordinators.
The first step was to transform this content into HTML, so we split it between the 3 of us and did some copy-pasting, since the formatting of the .docx file was a bit tricky, we couldn't automate the translation.

Then, we added classes to target the 3 courses:

.fine-art
.lens-based
.xpub

Those classes allow us to section the content and colour-code each course in the text.

Michael is the main editor, thanks to the git pipeline we created he did the cleaning and rearrangement of the content in the HTML file.
While working on the layout, we discovered that one of the main sections is a bit messy and repetitive, so we agreed on grouping it's content relatively to each course rather than to themes, to avoid repetitions. This also allowed us to use more efficient and creative styling for this part.