PuddleServer

From PuddleNet

File and data server within a hierarchy for sign language.

Contents 1 Data Server 2 Integrated SignMaker 3 Directory Structure 3.1 Main index 3.2 Common Dir Puddle Files 3.2.1 index.php 3.2.2 redirect.php 3.3 Data files 3.4 Directory 3.4.1 File 3.5 System files 3.6 User Interface 3.7 User 3.8 Common 3.9 Private

[edit] Data Server

• Session data
• import / export
• GET and POST for web pages

[edit] Integrated SignMaker

This should be embedded with puddle screen elements SignBox, SymbolList, SymbolPalette, special commands. Integrated SignMaker is for extended support.

SignMaker may also be called externally with a query call. Includes pre-text, post-text, server, directory, page, method (get or post), and other static query elements. External SignMaker is planned for basic support. External SignMaker is available in the SignWriting MediaWiki Plugin or MediaWiki.org.

[edit] Directory Structure

[edit] Main index

index.php is the main work script. All pages page redirect to the main index page to do work. All other pages are data files with locks for reading, writing, managing, and admin.

[edit] Common Dir Puddle Files

In the puddle folder, there are 3 files: index.php, redirect.php, README.txt.

[edit] index.php

This file is optional. Without this file, directory access is possible. With the default file, redirect.php is called with all get and post attributes.

[edit] redirect.php

This file is dual purpose. First, it loads a directory into the main index page. Second, it is included in every data file within the puddle hierarchy.

[edit] Data files

Files contain data in various formats

• comma separated values (.csv)
• hex with ascii (.hex)
• 7-bit ascii (.asc)
• ABNF Notation(.abnf)
• Cascading style sheets(.css)
• base64 (.bas)

Files contain several locks

• read
• write
• manage
• admin

Files contain keys

• keys are 7-bit ascii
• stored as plain text or ssh

Files can contain versions

• main data still used
• version is an array
• first backup starts versioning
• numbered from 1
• no diff between latest version and live means the file is up to date.

Files can contain access logs

• ip
• key
• time
• notes

[edit] Directory

[edit] File

• In directory, file is named .dir and used by default
• In parent directory, file is named sub_directory_name.dir and used as override

For a dir_file, locks and keys apply to reading and writing all files in directory.

The data within a dir_file contains configuration options and settings.

[edit] System files

sys is a top level directory in the puddle hierarchy. Sys contains key data that controls how the main index page looks and works.

[edit] User Interface

ui is a top level directory in the puddle hierarchy. Contains user interface information in multiple formats.

[edit] User

user is a top level directory that is uniquely created for special users.

[edit] Common

common is a top level directory that is uniquely created for public viewing.

[edit] Private

private is a top level directory that is uniquely created for private work.