ruwiki 0.9.0

data/lib/ruwiki/lang/es.rb

@@ -0,0 +1,339 @@
+#--
+# Ruwiki
+#   Copyright � 2002 - 2004, Digikata and HaloStatue
+#   Alan Chen (alan@digikata.com)
+#   Austin Ziegler (austin@halostatue.ca)
+#   Mauricio Julio Fern�ndez Pradier (batsman.geo@yahoo.com)
+#
+# Licensed under the same terms as Ruby.
+#
+# $Id: es.rb,v 1.15 2004/11/28 23:28:16 austin Exp $
+#++
+module Ruwiki::Lang
+    # Ruwiki::Lang::ES is the English-language output module. It contains a
+    # hash, *Message*, that contains the messages that may be reported by
+    # any method in the Ruwiki library. The messages are identified by a
+    # Symbol.
+  module ES
+    Message = Hash.new { |hh, kk| hh[kk] = "ERROR: Identificador de mensaje desconocido: #{kk.inspect}."; hh[kk] }
+    message = {
+        # The encoding for the webpages. This should match the encoding used
+        # to create these messages.
+      :charset_encoding             => "iso-8859-15",
+        # Backend-related messages.
+      :backend_unknown              => "Backend %1$s desconocido.",
+      :cannot_create_project        => "No pudo crearse el proyecto %1$s: %2$s",
+      :cannot_destroy_project       => "No pudo borrarse el proyecto %1$s: %2$s",
+      :cannot_destroy_topic         => "No pudo borrarse %1$s::%2$s: %3$s",
+      :cannot_obtain_lock           => "No pudo obtenerse el cerrojo para %1$s::%2$s. Reint�ntelo de nuevo en breve.",
+      :cannot_release_lock          => "No pudo liberarse el cerrojo para %1$s::%2$s. Reint�ntelo de nuevo en breve.",
+      :cannot_retrieve_topic        => "No pudo obtenerse %1$s::%2$s: %3$s",
+      :cannot_store_topic           => "No pudo almacenarse %1$s::%2$s: %3$s",
+      :cannot_list_topics           => "No se pudo listar los temas del proyecto %1$s: %2$s",
+      :error_creating_lock          => "Error al crear el cerrojo para %1$s::%2$s: %3$s",
+      :error_releasing_lock         => "Error al liberar el cerrojo para %1s::%2$s: %3$s",
+      :flatfiles_no_data_directory  => "El directorio de datos (%1$s) no existe.",
+      :no_access_list_projects      => "Permiso denegado al listar los proyectos.",
+      :no_access_list_topics        => "Permiso denegado al listar los temas del proyecto %1$s.",
+      :no_access_to_create_project  => "Permiso denegado al crear el proyecto %1$s.",
+      :no_access_to_destroy_project => "Permiso denegado al borrar el proyecto %1$s::%2$s.",
+      :no_access_to_destroy_topic   => "Permiso denegado al borrar el borrar el tema %1$s::%2$s.",
+      :no_access_to_read_topic      => "Permiso denegado al acceder a %1$s::%2$s.",
+      :no_access_to_store_topic     => "Permiso denegado al almacenar %1$s::%2$s.",
+      :page_not_in_backend_format   => "%1$s::%2$s no est� en un formato soportado por el backend %3$s.",
+      :project_already_exists       => "El proyecto %1$s ya existe.",
+      :project_does_not_exist       => "El proyecto %1$s no existe.",
+      :search_project_fail          => "Error al buscar la cadena %2$s en el proyecto %1$s.",
+      :yaml_requires_182_or_higher  => "El soporte para archivos YAML s�lo est� disponible en Ruby versi�n 1.8.2 o superior.",
+      :not_editing_current_version  => <<EOM ,
+Ha enviado una versi�n antigua de %1$s::%2$s. Las diferencias entre su versi�n
+y la actual han sido fusionadas. En caso de conflicto, las l�neas de ambas 
+versiones ser�n mostradas. Aseg�rese de editar la p�gina en su totalidad
+antes de salvar de nuevo.
+EOM
+      :no_empty_search_string       => <<EOM ,
+El campo de b�squeda no puede estar vac�o. Por favor introduzca el texto
+a buscar antes de pulsar sobre el bot�n de b�squeda.
+EOM
+      :page_is_locked               => "La pagina no puede ser editada al estar bloqueada en este momento. Por favor espere unos minutos y vuelva a intentar.",
+
+        # Config-related messages.
+      :config_not_ruwiki_config     => "La configuraci�n debe ser de clase Ruwiki::Config.",
+      :invalid_template_dir         => "El path para plantillas (%1$s) no existe o no es un directorio.",
+      :no_template_found            => "No pudo encontrarse la plantilla para %1$s en el conjunto %2$s.",
+      :no_template_set              => "No pudo encontrarse el conjunto de plantillas '%1$s' en el path.",
+      :no_webmaster_defined         => "Error de configuraci�n: Webmaster no est� definido.",
+        # Miscellaneous messages.
+      :complete_utter_failure       => "Error catastr�fico",
+      :editing                      => "Edici�n",
+      :error                        => "Error",
+      :invalid_path_info_value      => "Algo huele a podrido en su entorno Web. PATH_INFO = %1$s",
+      :render_arguments             => "Ruwiki#render debe ser llamado con cero o dos argumentos.",
+      :unknown_feature              => "Caracter�stica desconocida: %1$s.",
+      :topics_for_project           => "Temas del Proyecto ::%1$s",
+      :project_topics_link          => "(temas)",
+      :wiki_projects                => "Proyectos en %1$s",
+      :no_projects                  => "Ning�n proyecto.",
+      :no_topics                    => "El proyecto %1$s no tiene nig�n tema.",
+      :search_results_for           => "= Resultados de la b�squeda de: %1$s",
+      :number_of_hits               => "%1$d Resultados",
+
+        # Labels
+      :label_search_project         => "Buscar en projecto",
+      :label_search_all             => "Todo",
+      :label_search                 => "Buscar: ",
+      :label_project                => "Proyecto: ",
+      :label_topic                  => "Tema: ",
+      :label_edit                   => "Editar",
+      :label_recent_changes         => "Cambios recientes",
+      :label_topics                 => "Temas",
+      :label_projects               => "Proyectos",
+      :label_editing                => "Edici�n",
+      :label_text                   => "Texto:",
+      :label_text_accelerator       => "T",
+      :label_edit_comment           => "Editar Comentario: ",
+      :label_comment_accelerator    => "O",
+      :label_save                   => "Salvar",
+      :label_save_accelerator       => "S",
+      :label_cancel                 => "Cancelar",
+      :label_cancel_accelerator     => "C",
+      :label_preview                => "Previsualizar",
+      :label_preview_accelerator    => "P",
+      :label_original_text          => "Text Original",
+      :label_raw                    => "Crudo",
+      :label_formatted              => "Formateado",
+      :label_send_report_by         => "Enviar notificaci�n al administrador del Wiki por email.",
+      :label_send_report            => "Enviar notificaci�n.",
+      :label_saved_page             => "P�gina salvada: ",
+
+        # Messages from Ruwiki::Utils::Converter
+        # Note to translators: certain words should be left alone. These
+        # will be marked in comments. Description lines are restricted to 40
+        # characters and should be an array. Use this as a ruler.
+        #                           => [ "----------------------------------------" ]
+      :converter_usage              => "Modo de empleo: %1$s [opciones] <dir.>",
+      :converter_format_desc        => [ "Convertir los ficheros encontrados",
+                                         "(independientemente de su formato), al",
+                                         "formato especificado; por defecto ",
+                                         "archivos planos. Formatos permitidos:",
+                                         "   yaml marshal flatfiles" ],
+      :converter_backup_desc        => [ "Crear copias de seguridad de ficheros ",
+                                         "actualizados. La opci�n por defecto es ",
+                                         "--backup." ],
+      :converter_backupext_desc     => [ 'Especificar la extensi�n para las copias',
+                                         'de seguridad (por defecto "~") que se',
+                                         'a�ade al nombre del fichero de datos' ],
+      :converter_backupext_error    => [ "La extensi�n para copias de seguridad",
+                                         "no debe estar vac�a." ],
+      :converter_extension_desc     => [ "Especifica la extensi�n de los ficheros",
+                                         "de datos de Ruwiki (por defecto .ruwiki)" ],
+      :converter_extension_error    => "La extensi�n no debe estar vac�a.",
+      :converter_noextension_desc   => [ "Indica que los ficheros de datos de",
+                                         "Ruwiki no tienen ninguna extensi�n." ],
+      :converter_quiet_desc         => [ "Ejecuci�n silenciosa. Por defecto se ",
+                                         "ejecuta con mensajes normales." ],
+      :converter_language_desc      => [ "Especifica el idioma a emplear con LANG.",
+                                         "Por defecto 'en' (ingl�s).",
+                                         "Idiomas disponibles:  en es de" ],
+      :converter_verbose_desc       => [ "Informaci�n detallada de ejecuci�n.",
+                                         "Por defecto se ejecuta con un nivel de ",
+                                         "detalle inferior." ],
+      :converter_help_desc          => [ "Mostrar este texto." ],
+      :converter_num_arguments      => "Error: n�mero de argumentos insuficiente.",
+      :converter_directory          => "directorio",
+      :converter_converting_from    => "convertiendo de %1$s a %2$s ... ",
+      :converter_done               => "hecho.",
+      :converter_not_ruwiki         => "no es un fichero de Ruwiki; ignorando.",
+      :converter_nosave_modified    => "no pudo salvarse %1$s.",
+      :converter_page_format_error  => "Error: No pudo detectarse el formato de la p�gina.",
+
+        # Messages from Ruwiki::Utils::Manager
+      :manager_unknown_command      => "Comando desconocido: %1$s",
+      :manager_help_commands        => <<EOH ,
+Los comandos reconocidos por 'ruwiki' son:
+
+    ruwiki install              Instala el entorno por defecto.
+    ruwiki package              Empaqueta una instalaci�n de Ruwiki.
+    ruwiki unpackage            Desempaqueta una instalaci�n de Ruwiki.
+    ruwiki service              Gestiona un Win32::Service para Ruwiki.
+
+EOH
+      :manager_help_help            => <<-EOH ,
+Este es un mensaje de ayuda b�sico con referencias a informaci�n suplementaria
+relativa a esta herramienta de la l�nea de comandos. Intente:
+
+    ruwiki help commands        mostrar todos los comandos de ruwiki
+    ruwiki help <COMANDO>       mostrar ayuda sobre <COMANDO>
+                                  (p.ej., 'ruwiki help install')
+
+EOH
+      :manager_missing_parameter    => "Falta par�metro para la opci�n: %1$s",
+      :manager_dest_not_directory   => "El destino (%1$s) no es un directorio.",
+      :manager_service_broken       => "No pudo crearse un servicio de Win32 al no estar instalado Win32::Service.", 
+      :manager_install_help         => <<-EOH ,
+    ruwiki install [OPCIONES] [--to DEST]
+
+Crea una instancia de Ruwiki. Por defecto, se instala los ficheros de datos,
+plantillas y la configuraci�n por defecto en el directorio actual. El destino
+puede ser cambiado con la opci�n --to, y los elementos a instalar con la lista
+de OPCIONES, que puede ser delimitada por espacios, comas o puntos y comas.
+As� pues,
+
+    ruwiki install data;servlet
+    ruwiki install data,servlet
+    ruwiki install data servlet
+
+son equivalentes. Las opciones pueden especificarse en may�sculas/min�sculas.
+Las opciones de instalaci�n son:
+
+    servlet       # Instala el stub para el servlet Ruwiki
+    service       # Instala el stub para el Win32::Service Ruwiki
+    CGI           # Instala el script CGI Ruwiki
+    data          # Instala los datos, plantillas y configuraci�n de Ruwiki
+
+Las opciones pueden deshabilitarse precedi�ndolas de un gui�n o 'no':
+
+    ruwiki install cgi -data
+    ruwiki install cgi nodata
+
+instalar�n el script CGI pero no los datos.
+EOH
+      :manager_package_help         => <<-EOH ,
+    ruwiki package [FUENTE] [--output PAQUETE] [--replace]
+    ruwiki package [FUENTE] [-o PAQUETE] [--replace]
+
+Empaqueta los ficheros de Ruwiki (datos, plantillas y ejecutables) de la
+FUENTE especificada o el directorio actual en el archivo de salida
+especificado (o "../%1$s"). Si la FUENTE es un fichero de configuraci�n
+de rukiwi (p.ej. "%2$s"), ser� empleado para determinar la localizaci�n
+y el nombre de los directorios de datos y plantillas.
+
+    NOTA: El proceso de empaquetado normaliza los nombres de los
+          ficheros de datos y plantillas para que sean relativos al
+          directorio de desempaquetado. NUNCA ser�n paths absolutos.
+
+EOH
+      :manager_unpackage_help       => <<-EOH ,
+    ruwiki unpackage [FUENTE] [--output DIRECTORIO]
+    ruwiki unpackage [FUENTE] [-o DIRECTORIO]
+
+Desempaqueta el paquete de Ruwiki provisto (por defecto "./%1$s")
+en el directorio indicado (por defecto ".").
+EOH
+      :manager_service_lo_argcount  => "Argumentos insuficientes: %1$s",
+      :manager_service_hi_argcount  => "Demasiados argumentos: %1$s",
+      :manager_service_help         => <<-EOH ,
+    ruwiki service install NOMBRE [DESCRIPCION] [opciones]
+    ruwiki service start   NOMBRE
+    ruwiki service stop    NOMBRE
+    ruwiki service delete  NOMBRE
+
+Gestiona el servlet Ruwiki para WEBrick como un servicio de Windows, bajo el
+NOMBRE indicado. install soporta adem�s las opciones siguientes:
+
+  --rubybin RUBYPATH      Path del ejecutable Ruby.
+  --exec    SERVICEPATH   Path del ejecutable del servicio.
+  --home    PATHTOHOME    Path del directorio home.
+EOH
+      :manager_package_exists       => "El paquete %1$s ya existe.",
+      :manager_service_installed    => "Servicio %1$s instalado.",
+      :manager_one_moment           => "Un momento, %1$s ...",
+      :manager_service_started      => "Servicio %1$s iniciado.",
+      :manager_service_stopped      => "Servicio %1$s parado.",
+      :manager_service_deleted      => "Servicio %1$s borrado.",
+
+        # Messages from Ruwiki::Utils::Converter
+        # Note to translators: certain words should be left alone. These
+        # will be marked in comments. Description lines are restricted to 40
+        # characters and should be an array. Use this as a ruler.
+        #                           => [ "----------------------------------------" ]
+      :runner_usage                 => "Modo de empleo: %1$s [opciones]",
+      :runner_general_options       => "Opciones generales:",
+      :runner_saveconfig_desc       => [ "Salvar la configuraci�n en FILENAME y",
+                                         "salir. Si no se emplea FILENAME, la",
+                                         "configuraci�n por defecto ser� usada.",
+                                         "Todas las opciones ser�n le�das del",
+                                         "fichero existente y de la l�nea de",
+                                         "comandos y salvadas. El servlet no se",
+                                         "arrancar�. El nombre por defecto es:" ],
+      :runner_config_desc           => [ "Leer la configuraci�n por defecto de",
+                                         "FILENAME en vez del fichero por defecto",
+                                         "Las opciones especificadas anteriormente",
+                                         "ser�n sobrescritas" ],
+      :runner_webrick_options       => "Opciones de WEBrick:",
+      :runner_port_desc             => [ "Ejecutar el servlet Ruwiki en el puerto",
+                                         "especificado; por defecto 8808." ],
+      :runner_address_desc          => [ "Aceptar �nicamente conexiones desde las",
+                                         "direcciones especificadas (separadas por",
+                                         "comas). Puede usarse repetidamente. Por",
+                                         "defecto todas las direcciones ser�n",
+                                         "aceptadas" ],
+      :runner_local_desc            => [ "Aceptar �nicamente conexiones locales",
+                                         "(127.0.0.1). Anula las direcciones",
+                                         "indicadas previamente en -A" ],
+      :runner_mountpoint_desc       => [ "URI relativo en el que Ruwiki estar�",
+                                         'accesible. Por defecto "/".' ],
+      :runner_log_desc              => [ "Realizar log de la actividad de WEBrick.",
+                                         "Por defecto se usa --log." ],
+      :runner_logfile_desc          => [ "Fichero en el que escribir los logs de",
+                                         "WEBrick. Por defecto, el standard error." ],
+      :runner_threads_desc          => [ "Asigna al threadcount de WEBrick." ],
+      :runner_ruwiki_options        => "Opciones de Ruwiki:",
+      :runner_language_desc         => [ 'Idioma de la inferfaz de Ruwiki.',
+                                         'Por defecto "en". Puede ser "en", ',
+                                         '"de", o  "es".' ],
+      :runner_webmaster_desc        => [ 'Email del webmaster de Ruwiki.',
+                                         'Por defecto "webmaster@domain.tld".' ],
+      :runner_debug_desc            => [ 'Activa debugging de Ruwiki. Por defecto',
+                                         'inhabilitado.' ],
+      :runner_title_desc            => 'T�tulo del Ruwiki. Por defecto "Ruwiki".',
+      :runner_defaultpage_desc      => [ 'P�gina por defecto alternativa; por',
+                                         'defecto "ProjectIndex".' ],
+      :runner_defaultproject_desc   => [ 'Proyecto por defecto. Por defecto',
+                                         '"Default".' ],
+      :runner_templatepath_desc     => [ 'Localizaci�n de las plantillas.',
+                                         'Por defecto "./templates".' ],
+      :runner_templatename_desc     => [ 'Nombre de las plantillas. Por defecto',
+                                         '"default".' ],
+      :runner_cssname_desc          => [ 'Nombre del fichero CSS en el directorio',
+                                         'de plantillas. Por defecto "ruwiki.css".' ],
+      :runner_storage_desc          => [ 'Tipo de almacenamiento:' ],
+      :runner_datapath_desc         => [ 'Path donde salvar los ficheros de datos.',
+                                         'Por defecto; "./data".' ],
+      :runner_extension_desc        => [ 'Extensi�n para ficheros de datos.',
+                                         'Por defecto "ruwiki".' ],
+      :runner_central_desc          => [ 'Ejecuta Ruwiki con los datos del',
+                                         'directorio RubyGem.' ],
+      :runner_general_info          => "Informaci�n general:",
+      :runner_help_desc             => [ "Muestra este texto." ],
+      :runner_version_desc          => [ "Muestra la versi�n de Ruwiki." ],
+      :runner_rejected_address      => "Direcci�n remota %1$s rechazada. S�lo se admiten conexiones desde %2$s.",
+      :runner_banner                => <<-BANNER ,
+%1$s
+
+Opciones de WEBrick:
+  Puerto                 %2$d
+  Direcciones admitidas  %3$s
+  Punto de montaje       %4$s
+  Logging?               %5$s
+  Destino del log        %6$s
+  Hebras                 %7$s
+
+Opciones de Ruwiki:
+  Webmaster              %8$s
+  Debugging?             %9$s
+  T�tulo                 %10$s
+  Proyecto por defecto   %11$s
+  P�gina por defecto     %12$s
+  Path para plantillas   %13$s
+  Conjunto de plantillas %14$s
+  Fuente CSS             %15$s
+
+  Tipo de almacenamiento %16$s
+  Path de datos          %17$s
+  Extensi�n              %18$s
+BANNER
+    }
+    message.each { |kk, vv| Message[kk] = vv }
+  end
+end

data/lib/ruwiki/page.rb

@@ -0,0 +1,262 @@
+#--
+# Ruwiki
+#   Copyright � 2002 - 2004, Digikata and HaloStatue
+#   Alan Chen (alan@digikata.com)
+#   Austin Ziegler (ruwiki@halostatue.ca)
+#
+# Licensed under the same terms as Ruby.
+#
+# $Id: page.rb,v 1.13 2004/09/27 04:48:27 austin Exp $
+#++
+require 'ruwiki/exportable'
+
+  # The page class for Ruwiki. The page defines the data and meta-data for a
+  # page.
+class Ruwiki::Page
+  include Ruwiki::Exportable
+
+  exportable_group 'ruwiki'
+    # Returns the content version of the page. If the page has a greater
+    # content version than this version of Ruwiki does, we should probably
+    # throw an exception, because attempting to save such a page will cause
+    # a loss of data. Immutable.
+    #
+    # Class:: +ruwiki+
+    # ID::    +content-version+
+  attr_reader :content_version
+  exportable :content_version
+    # Returns the version of Ruwiki from which this page was generated.
+    # Informational only. Immutable.
+    #
+    # Class:: +ruwiki+
+    # ID::    +version+
+  attr_reader :ruwiki_version
+  exportable :ruwiki_version, :name => 'version'
+
+  exportable_group 'properties'
+    # Returns or sets the displayed title of the page, which may differ from
+    # the topic of the page. As of Ruwiki 0.8.0, this is not currently used
+    # and it may disappear.
+    #
+    # Class:: +properties+
+    # ID::    +title+
+  attr_accessor :title
+  exportable :title
+    # Returns or sets the topic of the page, which may differ from the
+    # title. This is used to set the topic on a page being saved.
+    #
+    # Class:: +properties+
+    # ID::    +topic+
+  attr_accessor :topic
+  exportable :topic
+    # Returns or sets the project of the page, which may differ from the
+    # title. This is used to set the project on a page being saved.
+    #
+    # Class:: +properties+
+    # ID::    +project+
+  attr_accessor :project
+  exportable :project
+    # Returns or sets the creator of the page. Unless we know the user
+    # (through the authentication mechanism, only partially implemented for
+    # Ruwiki 0.9.0), this will be +nil+.
+    #
+    # Class:: +properties+
+    # ID::    +creator+
+  attr_accessor :creator
+  exportable :creator
+    # Returns or sets the creator's IP address. This should always be set.
+    # It will have a value of "UNKNOWN" on the off-chance that something
+    # prevents this from working.
+    #
+    # Class:: +properties+
+    # ID::    +creator-ip+
+  attr_accessor :creator_ip
+  exportable :creator_ip
+    # Returns or sets the date of creation.
+    #
+    # Class:: +properties+
+    # ID::    +create-date+
+  attr_accessor :create_date
+  exportable :create_date
+    # Returns or sets the last editor of the page. Unless we know the user
+    # (through the authentication mechanism, only partially implemented for
+    # Ruwiki 0.9.0), this will be +nil+.
+    #
+    # Class:: +properties+
+    # ID::    +editor+
+  attr_accessor :editor
+  exportable :editor
+    # Returns or sets the last editor's IP address. This should always be
+    # set. It will have a value of "UNKNOWN" on the off-chance that
+    # something prevents this from working.
+    #
+    # Class:: +properties+
+    # ID::    +editor-ip+
+  attr_accessor :editor_ip
+  exportable :editor_ip
+    # Returns or sets the date of the last edit.
+    #
+    # Class:: +properties+
+    # ID::    +edit-date+
+  attr_accessor :edit_date
+  exportable :edit_date
+    # Indicates whether the page is editable. Non-editable pages are
+    # effectively static pages.
+    #
+    # Class:: +properties+
+    # ID::    +editable+
+  attr_accessor :editable
+  exportable :editable
+    # Indicates whether the page is indexable. Non-indexable pages are
+    # invisible to compliant web robots, and their links may not be
+    # followed.
+    #
+    # Class:: +properties+
+    # ID::    +indexable+
+  attr_accessor :indexable
+  exportable :indexable
+    # The current version of the page. The old version is always (#version
+    # - 1).
+    #
+    # Class:: +properties+
+    # ID::    +version+
+  attr_accessor :version
+  exportable :version
+    # An array of complete tags that will appear in the HTML <HEAD> section.
+    # Can be used to specify additional CSS, <META> tags, or even JavaScript
+    # on a per-page basis. Currently unused.
+    #
+    # Class:: +properties+
+    # ID::    +html-headers+
+  attr_accessor :html_headers
+  exportable :html_headers
+    # The entropy of the page. This is a ratio of the number of lines
+    # changed in the file vs. the total number of lines in the file. This
+    # value is currently unused. (And, sad to say, I don't remember why
+    # I included it. However, it's an interesting value that may be useful
+    # in spam fighting techniques. It is currently stored in the meta-data,
+    # but that may change moving forward.)
+    #
+    # Class:: +properties+
+    # ID::    +entropy+
+  attr_reader :entropy
+  exportable :entropy
+    # The edit comment for the current revision of the page.
+    #
+    # Class:: +properties+
+    # ID::    +edit-comment+
+  attr_accessor :edit_comment
+  exportable :edit_comment
+
+  exportable_group 'page'
+    # The header content of the page. This is static content (in either Wiki
+    # or HTML formats) that appears before the editable contents of the
+    # page. If both this and Wiki-level header content are specified, this
+    # will appear *after* the Wiki-level header content.
+    #
+    # Class:: +page+
+    # ID::    +header+
+  attr_accessor :header
+  exportable :header
+    # The footer content of the page. This is static content (in either Wiki
+    # or HTML formats) that appears before the editable contents of the
+    # page. If both this and Wiki-level footer content are specified, this
+    # will appear *before* the Wiki-level footer content.
+    #
+    # Class:: +page+
+    # ID::    +footer+
+  attr_accessor :footer
+  exportable :footer
+    # The editable unformatted Wiki content of the page.
+    #
+    # Class:: +page+
+    # ID::    +content+
+  attr_accessor :content
+  exportable :content
+
+    # Creates a Ruwiki page. This must be created from the canonical export
+    # hash.
+  def initialize(exported = {})
+    ruwiki = exported['ruwiki']
+    @content_version  = (ruwiki['content-version'] || Ruwiki::CONTENT_VERSION).to_i
+    @ruwiki_version   = ruwiki['version']         || Ruwiki::VERSION
+
+    props = exported['properties']
+    @title        = props['title']
+    @topic        = props['topic']        || "NewTopic"
+    @project      = props['project']      || "Default"
+    @creator      = props['creator']      || ""
+    @creator_ip   = props['creator-ip']   || "UNKNOWN"
+    @create_date  = Time.at((props['create-date']  || Time.now).to_i)
+    @editor       = props['editor']       || ""
+    @editor_ip    = props['editor-ip']    || "UNKNOWN"
+    @edit_date    = Time.at((props['edit-date']    || Time.now).to_i)
+    @edit_comment = props['edit-comment'] || ""
+    case props['editable']
+    when "false"
+      @editable = false
+    else
+      @editable = true
+    end
+    case props['indexable']
+    when "false"
+      @indexable = false
+    else
+      @indexable = true
+    end
+    @entropy      = (props['entropy']      || 0).to_f
+    @html_headers = props['html-headers'] || []
+    @version      = (props['version']      || 0).to_i
+
+    page = exported['page']
+    @header       = page['header']  || ""
+    @content      = page['content'] || ""
+    @footer       = page['footer']  || ""
+
+      # Fix the possibility that the content might be an array of chunks.
+    @content = @content.join("") if @content.kind_of?(Array)
+
+    @content.gsub!(/\r/, "")
+  end
+
+    # Outputs the HTML version of the page.
+  def to_html(markup)
+      # Normalise the content, first
+    @content.gsub!(/\r/, "")
+    markup.parse(@content, @project)
+  end
+
+    # Provides the canonical export hash.
+  def export
+    sym = super
+
+    sym.each_key do |sect|
+      if sect == 'ruwiki'
+        sym[sect]['content-version'] = Ruwiki::CONTENT_VERSION
+        sym[sect]['version'] = Ruwiki::VERSION
+      else
+        sym[sect].each_key do |item|
+          case [sect, item]
+          when ['properties', 'create-date'], ['properties', 'edit-date']
+            sym[sect][item] = sym[sect][item].to_i
+          when ['properties', 'editable'], ['properties', 'indexable']
+            sym[sect][item] = (sym[sect][item] ? 'true' : 'false')
+          else
+            sym[sect][item] = sym[sect][item].to_s
+          end
+        end
+      end
+    end
+
+    sym
+  end
+
+  NULL_PAGE = {
+      'ruwiki' => {
+        'content-version' => Ruwiki::CONTENT_VERSION,
+        'version'         => Ruwiki::VERSION
+      },
+      'properties' => { },
+      'page' => { },
+    }
+end