Difference between revisions of "Folios - Examples"

From TNG_Wiki
Jump to navigation Jump to search
(→‎Folio of html pages: Updated for Folios v2.07)
m (→‎Disclaimer: Added thanks to Rick Bisbee.)
Line 47: Line 47:
 
== Disclaimer ==
 
== Disclaimer ==
  
The information provided in this page is "all care, but no responsibility" courtesy [[User:Lochneil|Roger Clist]].
+
The information provided in this page is "all care, but no responsibility" courtesy [[User:Lochneil|Roger Clist]], who is extremely grateful to Rick Bisbee for developing the [[Folios]] facilty.
  
 
== See Also ==
 
== See Also ==

Revision as of 01:37, 24 April 2011

This page contains two examples of Folios in a working site. The folders displayed on this page are of a local PC copy of the server's filesystem, with the TNG root being at D:\Webs\Roots.

This page describes an early version of the folios technology, and needs updating. The examples reached by the links have now been upgraded to v2.07, so the details below are incorrect in several places. The images and their descriptions will be updated in the near future. In the meantime, for folio Version 2, substitute folio.php for docview.php, and note that index.php is derived from init.php in the folios distribution download.

Folio of jpg scans

The following image shows the files used to create a simple folio of jpg scans of typewritten pages. This folio "Howard Clare's Notes" may be browsed at The Clist Connections.

Folio-JPG-example.png

In this folio, the jpg images have been automatically named by the scanner which created them, and you will note that the files are conveniently datestamped in the order in which they were scanned. Therefore they did not need renaming. However, if extra pages needed to be added or inserted within the sequence, they could be easily renamed to arrange the folio in the desired order. The filenames themselves form no part in the folio's presentation, and the site visitor is unaware of their names.

This folio contains seven pages, and the page numbers displayed in the folio's window title conveniently agree with the page numbers on the typewritten sources. Note that there is no practical limit to the number of pages that can be held in a folio.

The folio's index.php file has been created from folio_index_template.php v1.2 with allowable file types restricted to jpg only. The pdf file was also created by the scanner, but with all pages concatenated into one document. It is accessed (downloaded) from a link in the folio's cover page, and opens in a new window.

The media body-text for this folio (at the time of writing) is very simple, as follows.

<P><A class=snlink href="folios/Howard_Clare1/index.php" target=_self>View Document Pages</A> 
<A class=snlink href="folios/Howard_Clare1/20100216172910600.pdf" target=_download>
Download PDF (1.4MB)</A></P>
<DIV class=folio><p>Cover page text, etc.</p></DIV>

Folio of html pages

The following image shows the files used to create a more complex folio of html pages created from source documents. Some of the folio pages have links to subpages (having their own images) and the entire file bundle is neatly contained within the folio. This folio "The Rossiter Report (Part 1)" may be browsed at The Clist Connections.

Folio-HTML-example.png

In this folio, the html pages have been individually named with a numeric prefix to ensure that they will be served in the desired order. A cover page starts the sequence. Note that each html page in this ordered set is incomplete in itself (in that it comprises only body text without <head> and <body> tags) being designed to be served by the folio.php script.

You can exercise considerable creativity in your folio cover and individual folio pages. In this example some of the folio pages contain <a href> links to other pages (a) within the folio, (b) within the site but outside the folio, and (c) to pages in external sites. The pages are relatively simple in themselves, but draw upon the site's CSS styles.

Note that the he folio's index.php file contains a line

$exclude[] = ".php";

as the php files in the folder are subpages of two of the folio's html files (pages 1 and 7), and their own subsidiary files (jpg images) are held in the folio's images folder (for tidiness) along with images belonging to the folio pages. This structure enables the entire folio to be copied/zipped, etc. in one bundle.

Image manipulation

When you are working with large numbers of scanned images of identical size such as jpg scans of historic papers, it is often helpful to manipulate them (crop, cut, resize, rename, add borders, adjust brightness, contrast, etc.) using FastStone Photo Resizer or IrfanView or similar program with batch mode options.

Disclaimer

The information provided in this page is "all care, but no responsibility" courtesy Roger Clist, who is extremely grateful to Rick Bisbee for developing the Folios facilty.

See Also