GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
DocSet::DocSet(3) User Contributed Perl Documentation DocSet::DocSet(3)

"DocSet::DocSet" - An abstract docset generation class

  use DocSet::DocSet::HTML ();
  my $docset = DocSet::DocSet::HTML->new($config_file);
  
  # must start from the abs root
  chdir $abs_root;
  
  # must be a relative path to be able to move the generated code from
  # location to location, without adjusting the links
  $docset->set_dir(abs_root => ".");
  $docset->scan;
  $docset->render;

  my $should_update = $self->should_update($src_path, $dst_path);

"DocSet::DocSet" processes a docset, which can include other docsets, documents and links. In the first pass it scans the linked to it documents and other docsets and caches this information and the objects for a later peruse. In the second pass the stored objects are rendered. And the docset is completed.

This class cannot be used on its own and has to be subclassed and extended, by the sub-classes which has a specific to input and output formats of the documents that need to be processed. It handles only the partial functionality which doesn't require format specific knowledge.

This class inherits from "DocSet::Config" and you will find the documentation of methods inherited from this class in its pod.

The following "public" methods are implemented in this super-class:

  • new

      $class->new($config_file, $parent_o, $src_rel_dir);
        
  • init

      $self->init($config_file, $parent_o, $src_rel_dir);
        
  • scan

      $self->scan();
        

    Scans the docset for meta data and tocs of its items and caches this information and the item objects.

  • scan_copy_the_rest

      $self->scan_copy_the_rest()
        

    Process the files that should be copied as is without processing (i.e. images, css files, etc). If any of the items have a timestamp newer than the corresponding copy in the target destination, the whole docset will be rebuilt.

    Only files that were modified will be copied during the render phase.

  • render

      $self->render();
        

    Calls the render() method of each of the stored objects and creates an index page linking all the items.

  • copy_the_rest

      $self->copy_the_rest()
        

    Copies the files which aren't processed (i.e. images, css files, etc.) and were modified as-is.

  • should_update

      my $should_update = $self->should_update($src_path, $dst_path);
        

    Compare the timestamps/existance of src and dst paths and return (true, reason) if src is newer than dst otherwise return (false, reason)

    If rebuild_all runtime is on, this always returns (true, reason)

The following methods should be implemented by the sub-classes.
  • parse
  • retrieve_meta_data
  • convert
  • complete

      $self->complete();
        

    put here anything that should be run after all the items have been rendered and all the meta info has been collected. i.e. generation of the index file, to link to all the links and the parent node if such exists.

Stas Bekman <stas (at) stason.org>
2005-09-02 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.