Blogotext

Spécifications du fichier de sauvegarde généré par Blogotext

Blogotext peut exporter sous la forme d'un fichier XML l'ensemble des articles et commentaires du blog. Le noms des tags ainsi que les images envoyés via le formulaire de blogotext peuvent aussi être inclus dans ce fichier XML.

La syntaxe du fichier XML est décrite ici, afin de vous permettre de créer facilement un script de conversion du format "blogotext" dans le format d'un autre moteur de blog ou CMS.

Description rapide

• Format de fichier : text/plain.
• Encodage de caractères : UTF-8
• Validité du code XML : non. Le fichier utilise un système de balisage, mais les balises XML obligatoires ne sont pas écrites. Le contenu des balises de l'archive n'est pas échapé non plus (avec "<![CDATA[", par exemple)

Il s'agit donc plus d'un fichier texte contenant des données qu'un véritable fichier XML

Contenu du fichier :

• Articles + Commentaires. Le nombre d'articles est choisis au moment de créer l'archive. Les commentaires des articles présents sont tous là. Chaque article/commentaires est le contenu d'un fichier source de Blogotext, sans traitement particulier (ni échapement, ni encadage…)
• Tags. Inclus au choix au moment de créer l'archive, sous la forme d'une suite de tags séparés par des virgules.
• Images. Inclus au choix au moment de créer l'archive. Chaque image est encodé au format BASE64, avec une nouvelle ligne (\n) tous les 64 caractères (qu'il faudra retirer lors de la lecture).

Syntaxe, balisage

Le fichier se découpe avec les balises <bt_backup_***>. Les “***” peuvent être : image, comment, article, item…

<bt_backup_database>

// articles et commantaires regroupés
   <bt_backup_items>
      <bt_backup_item>
         // item 1
      </bt_backup_item>
      ...
   </bt_backup_items>

// les tags
   <bt_backup_tags></bt_backup_tags>

// les images
   <bt_backup_imgs>
      <bt_backup_img>
         // image 1
      </bt_backup_img>
      ...
   </bt_backup_imgs>

</bt_backup_database>

Chaque 'item' et chaque 'img' est composé d'autres balises, par exemple, un "item" contient : un article et les commentaires associés à cet article. Un "img" contient le nom du fichier, son code BASE64 et sa signature sha1 :

<bt_backup_database>

   <bt_backup_items> // articles + commentaires
      <bt_backup_item> // article n°1 et ses commentaires
         <bt_backup_article> // l'article
               // contenu du fichier d'un article, sans la première ligne avec le "die()"
         </bt_backup_article>
         <bt_backup_comment> // les commentaires, les uns à la suite des autres
               // contenu du fichier d'un commentaire, sans la première ligne avec le "die()"
         </bt_backup_comment>
      </bt_backup_item>
   </bt_backup_items>

   <bt_backup_tags>tag1,tag2,tag3...</bt_backup_tags>

   <bt_backup_imgs> // toutes les images
      <bt_backup_img> // image n°1
         <bt_backup_img_name>nom du fichier image</bt_backup_img_name>
         <bt_backup_img_base64>
               // code base64 d'une image, découpé en lignes de 64 caractères
         </bt_backup_img_base64>
         <bt_backup_img_hash>hash sha1 du fichier</bt_backup_img_hash>
      </bt_backup_img>
   </bt_backup_imgs>

</bt_backup_database>

Voilà donc la structure du fichier de sauvegarde. Il suffit de vous créer un scripte de parsage si jamais vous voulez convertir la base de donnée de Blogotext dans un format autre (Wordpress, Pluxml…).