archivedoc

document resource for archive section.

Table of content

Introduction
File system
File viewer
Adding an item
Funny shenanigans

Introduction

The archive section is a place where things are stored like a storage, making use of any host's disc space, and use html as a clientside read-only file viewer. In an unpredicted future, however, this section could expand its purpose to not just function as a storage hub.

This section (folder of webpages), as well as the rest of this website (except where otherwise noted), is released under WTFPL (Do what the F*** you want to do) licence. You are free to copy, even a portion of this page, modify it entirely, sell or distribute it, for your own purposes, or use as a template for your own simple projects.

There are better ways to make a file viewer on the web, but with this project, the author who made it ("the author") wants to try and demonstrate how good can a file viewer be made, following the KISS (keep it simple stupid) principle and some lil grain of brain self-computation power. Only a minimal amount of JS used, but not for any crucial function.

This document is in progress and is subject to amend without prior notices. (cuz why lmao, i dont want to make a mailing list that would be sent to every 8 billion of the world population xdd)

File system

The "file system" is, de facto, a folder which contains files, for storage purpose.

Currently, there is one such file system on this archive, fs1.

File viewer

File viewer is a basic html page for viewing and indexing stored files. A conventional name for a file viewer is index.bfsv0.htm in order to avoid coincidental use case for any other index.htm/html files.
A file viewer may consist of a file list, a header title and comment, and root link on top.

a file list shows links to directly open files in browser. a folder link will just go to another directory with index.bfsv0.htm file.
header title gives the name of current directory. the comment line(s) may show general tips, notes and info for each directory.
root link shows navigational link(s) to website's homepage and/or root of the archive fs.

You can refer to the sample page source code to make it as a template to copypasta-create a new directory. Any extra items, additions, widgets or plug-ins can be added freely, as if it were free to do so. Because simply, you can. Yes.

Adding an item

This is no way much easier than just adding linked texts to your files using

 < a href="ur file here.lmao"> ur file here< /a>

(remove the space inbefore tag name btw). You will have to do it manually every time you add a new item to the directory, as a mean of indexing. That's simply how it works, don't complain. Otherwise get a better, more worthy way to view and manage your files online.

Funny shenanigans

You can apply a hidden element (a.k.a. hover-to-spoiler) to an item to add a pop-out note, extra info, or even prank viewers with Rick Astley's top hit. Use class="spoiler" for tags contain target text, and class="hide" for text you want to hide. This is possibly currently only work for one spoiler text per page. Refer to the css file here for an inside look. How this shit works:

... something's probably underway. Stay tuned for more.

archivedoc / last modified 25 nov 2024 / made with a very own doc template using plain html.