Importing Pages
This option allows an administrator to import an arbitrary amount of local files, all of which are treated as new pages. Two file formats are recognized:
- Pages written in XPF (eXtended Page Format) can be imported flawlessly, since XPF represents Pie's native storage format for pages. Pages saved with older software releases or that have been copied over from an other site can be converted and imported with little effort.
- Common files with arbitrary content can also be handled. Naturally, such files possess no properties or meta information but their file names and usually require additional manual editing after the import process is finished.
The following import options are available:
- File name
- Actually a file path, the File name specifies the location of the file or group of files that is to be imported. If a single file, only this particular file is processed. If the path turns out to be a directory, all immediate descendants in it are being processed.
- Group name
- The new page(s) can be made part of a group of pages all of which share the same root name. This changes the addressing mode for links contained on pages of that group to be relative to the group name unless the links specificly address absolute destinations. If unspecified, the imported pages are included into the root group.
- Substitutional author
- If specified, this author, i. e. user, serves as a replacement, if
- the file is a common file and contains no information about its creator, or
- the author specified in the XPF file does not exist on the local system.
- Adapt alternate delimiter
- Only the latest releases of Pie support a configurable alternate delimiter, which defaults to the pipe character (
|). If the links of the imported page(s) rely on blanks as the alternate delimiter, this option help to convert such links on the fly. - File name encoding
- Specifies the encoding method of the file name used for the imported file. Without the proper method while decoding the file name, that name, and thus the title of the page, will get messed up.
- Source character encoding
- Like the file name, the content of a file, too, may have been stored using various ways of encoding. Without selecting the proper decoding method, the contents can not be properly translated to UTF-8 and imported into the database.
Note that pages that already exist on the local site are refused and not being imported.