iPallet/Tuzura

iPallet/Tuzura for iOS 10, Version 1.7

(Japanese / English)

About iPallet/Tuzura

This application (APP) privately displays files imported by iTunes file sharing.

Important!: Please install "Tuzura" (Version 1.6) priority in iOS 9 and lower.

  • Various file formats (PDF, JPEG, GIF, PNG) can be displayed.
  • Option：The titles, order, etc. of files can be changed using the indexed file (index.xml).
  • Option：Once the top page file (index.html) is registered, the page replacing the initial guide can be displayed.
  • Bookmarks (Outlines) are available as a list in a PDF file. (Label changes a brown color to distinguish normal one.) (v.1.3+)

Simple utilization

You are easily usable in the following procedure. (These are unchanged from the first version.)

  1. The initial guide appears only when there is no file to be read.
  2. Connect the iOS device and iTunes application with the cable, and select this APP in iTunes file sharing.
  3. Register the file you want to share in the document. (You can update or delete the data on this page, too.)
  4. The list will be displayed when the APP starts. A refresh operation by pulling down the list is necessary after updating the file registration.
  5. Select the file to be displayed from the list.

More convenient utilization

Function enhancement is possible by the indexed file (index.xml). You may make the indexed file (index.xml) by yourself, and register using iTunes file sharing. (Please refer to formats on this support page.)

  • The hierarchical structure of the list is available. (v.1.2+)
  • Hierarchical data of the bookmarks displayed in a PDF file can be controlled. (v.1.3+)
  • The direction of movement of a page can be set. (v.1.3+)

The limitation of this version

  • Match case is available for the file-names.
  • A page may include some links, but it never links to external sites.
  • Only the text can be displayed as a list.
  • A default page direction of PDF page is Left-to-Right. A directions of touch operations is same as the page direction.
  • The PDF protected by a password is not displayed.
  • The link in the PDF is ignored.

Optional formats (Slightly difficult utilization)

Technical terms are included in the following description.

Using an option, you can introduce your private documents without depending on the network. In addition, you can apply it to simple display by using iPad access guide function.

You can return to a state of shipment by deleting all files by iTunes file sharing. (Be careful! However, before deleting files, you should back them up by yourself.)

Indexed file (index.xml)

Sample format (1)

<?xml version="1.0" encoding="utf-8"?>
<items>
    <item label="App Guide (PDF)" src="ApplicationGuide.pdf" />
    <item label="User's guide (PDF)" src="_UsersManual-2014.pdf" />
    <item label="Sample Image-1 (JPEG)" src="24.JPG" />
    <item label="Sample Image-2 (JPEG)" src="25.JPG" />
    <item label="Sample Image-3 (PNG)" src="a_Sample09.png" />
    <item src="a_Sample09.png" />Sample Image-3 (PNG)</item>
    <item label="Sample Image-4 (PNG)" src="a_Sample10.png" />Sample Image-4 (Large)</item>
</items>
  • Set 'item' as an element name in the case of a file.
  • Attribute 'label': The value is appeared in the list as a label. If the label value is long, it is displayed the part automatically. If it is not use the 'label', it is displayed a value of attribute 'src' (which is explained next).
  • Attribute 'src': Set a file name to display. Write the file name with extension definitely.
  • File format: utf-8, LF (Unix, OSX) (is recommended).
  • Text node: It is used for a title in the navigation bar. If the label value is long, it is displayed the part automatically. When there is not a text node, it is used a value of the 'label' attribute. (v.1.3+)

Sample format (2) (v.1.2+)

<?xml version="1.0" encoding="utf-8"?>
<items label="Sample Format">
    <item label="App Guide (PDF)" src="ApplicationGuide.pdf" />
    <item label="User's guide (PDF)" src="_UsersManual-2014.pdf" />
    <items label="Sample Images">
        <item label="Image-1 (JPEG)" src="24.JPG" />
        <item label="Image-2 (JPEG)" src="25.JPG" />
        <item label="Image-3 (PNG) [W] " src="a_Sample09.png" frame="wide" />
    </items>
    <item src="a_Sample09.png" />Sample Image-3 (PNG)</item>
</items>
  • Set 'items' as an element name in the case of a group. > mark is displayed in the right-side end of the label.
  • Attribute 'label' of element 'items': Group name is displayed as a label of the list and a title in the navigation bar.
  • Attribute 'frame' of element 'item': If this value is 'wide', the view becomes wide by tapping the list item in the landscape orientation. (The view becomes a normal split view when it comes back from the sleep mode or the portrait orientation.)

Sample format (3) for PDF (v.1.3+)

<?xml version="1.0" encoding="utf-8"?>
<items label="Sample">
    <!-- Default（Initial page:1, Left top Right page direction,
        Bookmark displays until layer 5) -->
    <item label="App Guide (PDF)" src="ApplicationGuide.pdf" />

    <!-- Initial page:1, Left top Right page direction, Bookmark displays until layer 2 -->
    <item label="App Guide (PDF)" src="ApplicationGuide.pdf"
                frontpage="1" pagedirection="LTR" maxlevel="2" />

    <!-- Initial page:3, Right to Left (Japanese Top to Bottom writing) page direction,
        No display bookmark if it is exists in PDF. -->
    <item label="User's guide (PDF)" src="_UsersManual-2014.pdf"
                frontpage="3" pagedirection="RTL" maxlevel="0" />
</items>
  • The following attributes are effective for PDF only.
  • Attribute 'frontpage': You can set a front page of PDF with numbers more than 1. A default front page number of PDF is 1 (the top page). If there is not the attribute, It is set the top page.
  • Attribute 'pagedirection': You can set a page direction 'RTL' (Right to Left) like a Japanese traditional book. The default value is 'LTR' (Left to Right).
  • Attribute 'maxlevel': You can set a hierarchical level of the PDF bookmarks. Number 1 shows the first level. The number can input to 5 (default). Number 0 hide bookmarks. A page link is necessary for each bookmark beforehand.

The other recipe of Indexed file (index.xml)

  • XML must be well-formed.
  • When there is not a real file, the label's color becomes gray and it is not selectable.
  • When there is not attribute 'label', the label shows the file name.
  • In the title, text node is given priority over a value of attribute 'label'. (v.1.3+)
  • If there is not attribute 'src' or the value or extension, the item is not displayed.
  • The element 'item' of the same contents is listed each merely.
  • The element 'items' of the same label is listed the first one only.

Top Page (index.html)

You can define only one top page. Be careful the following, and try yourself.

  • CSS and/or image (JPEG or PNG) etc. may be placed at the iTunes file sharing's hierarchy same as 'index.html' file. In such a case, if there is not the indexed file (index.xml), they will appear in the list.
  • It is possible to link to any sharing files (in sandbox) which can be showed by iOS's browser (precisely WebView) from 'index.html' file.
  • It is not necessary to describe the top page file (index.html) in the indexed file. It is treated for the top page only when App finds 'index.html'.
  • The format of 'index.html' does not prepare by this guidance.
  • The change of a title and a label of the top page set it with the label attribute of the route element 'items'.

Release Notes

Version 1.7 (2015-09-22,JST)

  • iOS10 was available (temporary).
  • This new name app "iPallet/Tuzura for iOS 10" is branch from 1.6.
  • A support of this version 1.7 changed iOS 8+.

Version 1.6 (2015-10-19,JST)

  • iOS9 was available.
  • The outline of PDF was corrected. (It was changed the iPad only showed outline.)
  • Important! : In iOS 10, this version 1.6 is not start.

Version 1.5 (2015-01-09,JST)

  • Support of iOS 8.
  • Bug fix for a single page PDF.

Version 1.4 (2014-06-20,JST)

  • Fade-out/in view (except PDF).
  • Landscape initial display size as wide can be set by an attribute of the indexed file (index.xml).
  • It limits loading of hidden files.
  • Internationalized.
  • Top page's label name trouble was fixed. (bug-fix)
  • File load trouble was fixed. (bug-fix)

Version 1.3 (2014-05-25,JST)

  • Bookmarks (Outlines) in a PDF file can be displayed as a file in selecting.
  • The bookmarks synchronize with a page movement of the PDF file.
  • Hierarchical data of the bookmarks displayed in a PDF file can be controlled by the indexed file (index.xml).
  • The direction of movement of a page can be set by the indexed file (index.xml).
  • The PDF file can be displayed by a viewer from the HTML link. (It does not link to external sites.)
  • The list and titles can be described separately by the indexed file (index.xml).

Version 1.2 (2014-05-18,JST)

  • The hierarchical display of the list is available by the description of the indexed file (index.xml).
  • The top page title can be set in the indexed file.
  • Troubles in the display occurring when Home button returns were fixed.
  • The display of the status bar was changed. (in iPad)

Version 1.1 (2014-05-09,JST)

  • The function to close the list is added with a landscape display.
  • Big-sized PDF files can be displayed.

Version 1.0 (2014-01-12,JST)

  • File formats (PDF, JPEG, GIF, PNG) can be displayed
  • Option：The titles, order, etc. of files can be changed using the indexed file (index.xml).
  • Option：Once the top page file (index.html) is registered, the page replacing the initial guide can be displayed.

Updated：2016-09-22 (JST)