Distribusi-verse
FAQ
What is distribusi?
Distribusi is a tool that can make web pages out of folders on your file system.
What is distribusi-verse?
Distribusi-verse is a content management system that uses distribusi to make simple websites. Distribusi-verse can also help you categorize and describe your sites and files so that they become navigatable and searchable.
Where are my files?
After uploading your zip archive your files are unzipped and kept in the stash folder.
What can I do with my files?
Visitors can navigate the sites via the main page and search for content via the search page. Maintainers can upload, describe, categorize, annotate and delete both distribusi sites and files.
How does it work?
1. Zipfiles become websites
Distribusi-verse is a content management system for the web that produces simple and fun websites based on files and folders that you upload from your computer. This means that you can upload a zip file (".zip file extension") with content and have distrubsi turn it into a webpage for you. Making a zip file is very easy for all desktop operating systems (Windows, Mac OS and Linux)
2. Media files become visible
Whenever Distribusi discovers media files in your zipfile it turns them into the appropriate html tags. image files become img tags, audio files become audio tags and so on. Currently distribusi supports images, videos, audio, pdf and textfiles (only ".txt" see 4. Text files become readable)
Example:
If your zipfile contains the image "cover.png" it becomes the following html in your distribusi page:
<div id="cover" class="png"> <figure> <img class="image" src="cover.png"> <figcaption>cover.png</figcaption> </figure> </div>
The encapsulating div tag gets an id that is the same as the file name. The img tag gets a class attribute image This is handy for styling your files with CSS (See 5.)
3. Folders become links and pages
A zipfile can contain folders with more content. Distribusi turns these automatically into links and behind those links a new page! These pages look identical to your main page because they share the same style.
Example:
<div id="folder" class="dir"> <a href='new_folder/index.html'>new_folder</a> </div>
The encapsulating div tag gets an id folder. and a class attribute dir This is handy for styling your files with CSS (See 5.)
the anchor (a) tag will get an href attribute pointing to the subfolder
4. Text files become readable
When distribusi discovers a text file (".txt file extension") it turns it into a pre tag with the text from the file in it. This enables users to add simple text elements to their pages.
Example:
<div id="my_textfile" class="plain"> <pre> contents of my_textfile.txt gets rendered inside a pre tag. </pre> <span class="filename">my_textfile.txt</span> </div>
The encapsulating div tag gets an id that is the same as the file name. and a class attribute plain This is handy for styling your files with CSS (See 5.)
5. Use CSS to style your page
Distribusi offers full support for styling your page with CSS.
Distrbusi-verse allows its users to skip this step by just selecting a basic theme or by selecting one of the themes other users have made public.
Alternatively a user can opt to make their own custom theme, either in a simple online editor or by uploading their own CSS file.
6. Link archives with search tags and descriptions
It is possible to specify search tags for an entire site. You can also add descriptions for an entire site or specific files in an site. These become searchable and allow others to find which sites and files relate to each other. You can collaborate with your fellow maintainers to use the same search tags. In practice, we expect that search terms will loosely match site descriptions making related sites and files easy to discover.