Editing
- is done in Markdown format
- editing buttons are protected with a password (soon)
- changes are tracked in a local git repo on the server, which produces the RecentChanges page
- all the pages are saved as Markdown files (
.md) on the server, and media files are saved in the same folder
Images
Two versions of each image are saved:
- one high res (about 1-4 MB)
- one thumb (max 20 KB)
There is a funny logic to how images are uploaded and stored. Ikiwiki attaches images to a page, which means that you can only see them in the "attachments" browser if you edit that page. The image is basically stored in a folder on a server with the name of the page. The wiki is basically a set of HTML pages and folders. This is how the eA:testpage2 is stored on the server:
├── tags
│ ├── eA:testpage2
│ │ ├── editorial.png
│ │ └── index.html
You can still use the image on another page, by linking to it accordingly, using the image path. For example, if an image "pixels.jpg" is attached to the page "books", you can link to it as ../books/pixels.jpg on another page.
├── books
│ ├── index.html
│ └── pixels.jpg
References and footnotes
For the references, i tested the usual markdown way to write them.
It's basically [^footnotename] to insert a note, and [^footnotename]:
This is my footnote. to write the text of the note. The latter can be
placed anywhere in the page, it just needs to be placed on a new line i
think.
The footnotes appear at the bottom of the page now, we can have a look at this later. It seems to be quite trivial to edit the template of the pages to change their positioning or appearance.
PDFing
There is a PDF version available for each of the issues of everything magazine (soon).
The PDFs are generated from the scans (.jpg images), using the order of the scans in each of the folders. The following command is used to turn all these scans into a PDF document, using Imagemagick's convert command:
$ convert -density 300 *.jpg -quality 80 everythingIssue##.pdf
Something to check: it could be that the order of the pages in the PDF is not correct... due to the way that the file system orders the scans based on their filenames. For example, this is the order of issue 1:
├── e1_01.jpg
├── e1_02.jpg
├── e1_03.jpg
├── e1_04.jpg
├── e1_05.jpg
├── e1_06.jpg
└── e1_07.jpg
Which looks fine.
But this is the order of issue 11:
├── e1110-11.jpg
├── e1111Cubit.jpg
├── e1112-13.jpg
├── e1114-15.jpg
├── e11.16_17.jpg
├── e1118-19.jpg
├── e1118-9.jpg
├── e11-1Cover.jpg
├── e1120-21.jpg
├── e1122-23.jpg
├── e11-2-3.jpg
├── e114-5.jpg
├── e116-7.jpg
└── e118-9.jpg
Which seems not correct?
This one we will need to sort by hand. I made a PDF for issue 11 with this command:
$ convert -density 300 e11-1Cover.jpg e11-2-3.jpg e114-5.jpg e116-7.jpg e118-9.jpg e1110-11.jpg e1112-13.jpg e1114-15.jpg e1111Cubit.jpg e1118-19.jpg e1120-21.jpg e1122-23.jpg -quality 80 everythingIssue11.pdf
Which created this PDF: https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue11/everythingIssue11.pdf
PDF list
Issue 1
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue1/everythingIssue1.pdf
Issue 2
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue2/everythingIssue2.pdf
Issue 3
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue3/everythingIssue3.pdf
Issue 4
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue4/everythingIssue4.pdf
Issue 5
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue5/everythingIssue5.pdf
Issue 6
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue6/everythingIssue6.pdf
Issue 7
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue7/everythingIssue7.pdf
Issue 8
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue8/everythingIssue8.pdf
Issue 9-10
Issue 11
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue11/everythingIssue11.pdf
Issue 12
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue12/everythingIssue12.pdf
Issue 13
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue13/everythingIssue13.pdf
Issue 14
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue14/everythingIssue14.pdf
Issue 15
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue15/everythingIssue15.pdf
Issue 16
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue16/everythingIssue16.pdf
Issue 17
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue17/everythingIssue17.pdf
Issue 18
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue18/everythingIssue18.pdf
Issue 19
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue19/everythingIssue19.pdf
Issue 20
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue20/everythingIssue20.pdf
Issue 21
https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/everythingIssue21/everythingIssue21.pdf
Volume 2.1
Volume 2.2
Volume 2.3
Volume 2.4
Volume 3.1
Volume 3.2
Volume 3.3
Volume 3.4
Volume 4.1
Volume 4.2
Layout
When working on the layout, the following files can be used:
- templates: /srv/everything-ikiwiki/templates/
- CSS: /srv/everything-ikiwiki/local.css
- to rebuild the wiki: /srv/everything-ikiwiki/update.sh
$ sh /srv/everything-ikiwiki/update.sh
Server
The archive is hosted on a small server called "rushtonhosts", located at Steve's home in Schiedam atm. It's a raspberry pi (3B?) and all the network traffic is routed through the XPUB HUB, more information about this setup can be found here.
On the server, the wiki is saved in two places:
/srv/everything-ikiwiki/(source files)/var/www/html/everything-magazine-archive/(static HTML files)
Source files
These files are used for:
- making changes in the configuration of the wiki
- running the image compression script
- making manual changes in the md script (not recommended to do!!)
- uploading bulk amounts of images
- changing the CSS
The files in this folder are the following:
.
├── create-thumbnails.sh
├── ikiwiki.git
├── ikiwiki.setup
├── local.css
├── pages
├── plugins
├── templates
└── update.sh
create-thumbnails.sh: script to make thumbnails for all the images + rewrite the image links to switch to thumbs (the high res image is accessible after a click)ikiwiki.git: this is the local git repo that tracks changesikiwiki.setup: configuration filelocal.css: all the custom CSS rules can be added herepages: all the Markdown files + media files are hereplugins: all plugins are here, see https://ikiwiki.info/plugins/ for available ikiwiki pluginstemplates: all template files are here in.tmplformat, which can be edited here; changes will apply after rebuilding the wikiupdate.sh: script to rebuild the wiki, output is saved to/var/www/html/everything-magazine-archive/
static HTML files
IMPORTANT: Don't make any edits to the files in this folder, not to the text nor to the CSS!
The pages are saved on the server in /var/www/html/everything-magazine-archive/, following this structure:
.
├── cgi-bin
├── favicon.ico
├── ikiwiki
├── ikiwiki.cgi
├── image.jpg
├── index.html
├── local.css
├── pagename
│ ├── image.jpg
│ ├── index.html
│ └── thumb
│ └── image.jpg
├── style.css
├── tags
│ ├── tagname
│ │ └── index.html
│ ├── tagname
│ │ └── index.html
│ ├── tagname
│ │ └── index.html
│ └── tagname
│ └── index.html
├── thumb
│ └── image.jpg
└── wikiicons
├── diff.png
├── email.png
├── openidlogin-bg.gif
├── revert.png
└── search-bg.gif