Difference between revisions of "Article Format"

From openZIM
Jump to navigation Jump to search
Line 4: Line 4:
* '''Namespace:''' A
* '''Namespace:''' A
* '''Path:''' /A/''URL''
* '''Path:''' /A/''URL''
** whereas ''URL'' is often identical to the ''Article Name'', but this is not a requirement (see [[ZIM File Format#URL pointer list (urlPtrPos)|URL pointer list]] and [[ZIM File Format#Title_pointer_list (titlePtrPos)]] for details).
** whereas ''URL'' is often identical to the ''Article Name'', but this is not a requirement (see [[ZIM File Format#URL Pointer List (urlPtrPos)|URL pointer list]] and [[ZIM File Format#Title_pointer_list (titlePtrPos)|title pointer list]] for details).


== Meta Data ==
== Meta Data ==

Revision as of 11:05, 17 October 2010

Article Text

Articles to be parsed and shown directly by the ZIM reader are stored as HTML body, without any layout except the formattings used in the article text (headlines, tables, images...).

Meta Data

Some publisher want to provide additional information for the reader application to individual articles, such as HTML Meta Data or a special layout around the article text.

By default the Meta Data can be non-existant or empty.

The Article Text and Article Meta Data are linked to each other by having the same URL.

  • Namespace: B
  • Path: /B/URL
    • whereas /B/URL is the Meta Data used for /A/URL.

Content Inclusion

The Article Text needds to be combined with Article Meta Data, therefore the Meta Data needs to define a placeholder where the Article Text has to be inserted.

Fetching Article Text vs. Article Meta Data

Links inside articles always use the A namespace to refer to other articles, so the zimlib does provide Article Text by default for any requests of namespace A.

To use the Article Meta Data you have to define a flag when opening a zimfile, so the zimlib is configured to include the Article Text into Article Meta Data before returning the data.