Archives OEK

Les oekakis ne se réduisant pas aux seules images, il a paru nécessaire de rendre possible l'archivage d'oekakis complets, c'est à dire non seulement de l'image, mais aussi des métadonnées gravitant autour, dans un double but :

• la possibilité d'archiver un oekaki (à long terme)

• la sauvegarde de copies de travail, qui permet de revenir en arrière après un éventuel problème

Sur e-Kaki, le lien situé à droite des oekakis permet d'enregistrer une archive du kaki, tel qu'il se trouvait au moment où elle a été demandée. Les fichiers oek sont normalement datés, et comportent l'identifiant numérique du kaki.

Vous pouvez aisément lire le contenu de l'archive en l'ouvrant avec un logiciel de compression/décompression quelconque (par exemple en la renommant en [nom].zip). S'y trouvent les fichiers décrits dans la partie Spécification.

Il existe aussi une extension firefox (hélas pour firefox 2) permettant de lire les fichiers .oek, et, quand l'alignement Saturne-Jupiter y est propice, de voir les animations de ShiPainter et PaintBBS.

Veuillez contacter le service technique. Il est conseillé de se munir d'offrandes variées.

/Veuillez noter que cette section est provisoire, et que ces spécifications vont très probablement être modifiées un jour ou l'autre./

Une archive oek est une archive au format zip [1] contenant impérativement les fichiers suivant :

• oekaki.xml
• oekaki.png
• hash

Ainsi qu'un nombre quelconque de fichiers oekaki.ext (avec ext l'extension du fichier).

Le fichier oekaki.xml est une description, au format xml, des métadonnées concernant l'oekaki (titre, auteur, commentaires, …) selon la DTD qui suit :

<!ELEMENT oekaki (board,id,author,title,date,author_comment,applet,image,time_spent,animation,collab,comments) >
<!ELEMENT board (#PCDATA) >
<!ELEMENT id (#PCDATA) >
<!ELEMENT author (#PCDATA) >
<!ELEMENT title (#PCDATA) >
<!ELEMENT date (#PCDATA) >
<!ELEMENT author_comment (#PCDATA) >
<!ELEMENT applet (#PCDATA) >
<!ELEMENT image (#PCDATA) >
<!ELEMENT time_spent (#PCDATA) >
<!ELEMENT animation (#PCDATA) >
<!ELEMENT collab EMPTY >
<!ELEMENT comments (comment)+ >
<!ELEMENT comment (id,author,content,date) >
<!ELEMENT content (#PCDATA) >
<!ATTLIST board url CDATA #REQUIRED >
<!ATTLIST applet label CDATA #REQUIRED >
<!ATTLIST image x CDATA #REQUIRED y CDATA #REQUIRED >
<!ATTLIST collab line_author CDATA #REQUIRED line_id CDATA #REQUIRED >

Le fichier hash est destiné à la signature de l'archive, dans le but d'en vérifier l'origine et l'intégrité, i.e. elle permet au producteur de l'archive de s'assurer qu'elle provient bien de lui, et qu'elle n'a pas été altérée. La méthode que nous utilisons consiste globalement à injecter dans une fonction de hash le contenu des fichiers oekaki.xml, oekaki.png, oekaki.ext1, …, oekaki.extN et à enregistrer le contenu dans hash.

Ce sont les données en tant que telles. Le fichier oekaki.png est l'image de l'oekaki, au format png [2]. Les fichiers oekaki.ext, où ext n'est ni xml ni png sont des fichiers de données complémentaires, le plus généralement fournis par l'applet (par exemple l'animation de l'oekaki). Actuellement, l'on connaît les formats suivants :

• .chi : fichier de calques de ChibiPaint : premier aperçu de l'applet
• .pch: fichier animation de ShiPainter et PaintBBS

Notes :

• [1] http://www.pkware.com/index.php?option=com_content&task=view&id=64&Itemid=107
• [2] http://www.w3.org/Graphics/PNG/