Tom Mueller wrote:
> Shawn,
> What is the correct way to select a theme?  I've noticed that editing 
> the web/config.shtml file works.

At the moment, that is the only way to select a theme.  I'm trying to 
figure out a better way to cutomise this content for SMF users, but I've 
been desperately trying avoid coupling the depot code to the depot pages.

One of my primary design goals with the templates was to ensure that 
users of the depot could have a completely different set of pages if 
they wanted without being restricted by the depot's design (with the api 
used to interact with the depot being the single point of restriction).

> Also, is there going to be some documentation that describes how to 
> customize the repository pages?  I'm looking for the following:

Documentation didn't fit into the timeline for getting the changes done, 
but it's obviously needed.

Here's the list of outstanding doc bugs:

1456 Need to have documentation on how to launch pkg.depot as a service
2604 repository attributes need to be documented
2615 need to document depot operations / protocol

...and this one I just filed:
5701 pkg.depotd manpage needs depot facing pages customisation documentation

> - what cfg_cache entries effect the pages?

* [repository] name -- changes the index page title
* [repository] description -- changes the about text on the index page

Other ones are planned in the future.

> - what command line options are useful when customizing the pages?

* --content-root; if you copy the /usr/share/lib/pkg/web directory to 
another location, you would then specify 
--content-root=/path/to/dir/containing_web_dir/ so you could fully 
customise the content yourself.

> - what files within the web area are useful to edit?  Which ones should 
> be edited?

* config.shtml unless you copy all the files somewhere else as described 
above.

> - what Python interface can be used from within the pages? (presumably 
> the server.api module)

* As far as the pkg modules go; only pkg.server.api should be used from 
within the templates.  Beyond that, any python modules may be used.

-- 
Shawn Walker
_______________________________________________
pkg-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/pkg-discuss

Reply via email to