On 4 Dec 2007, at 3:28 PM, James Harrison wrote: > On Dec 4, 2007, at 5:24 AM, Christiaan Hofman wrote: > >> With which part do you have trouble, writing the template or >> installing it in BibdDesk? For the latter both the Help and the Wiki >> have some step by step instructions. For writing, have you tried the >> new template editor? > > Just a few suggestions about the online manual material related to > templates, for when you have time to look at this :-) ... > > 1. There is some complexity to the templating system and it might be > helpful if there was an overview of templates either on the top-level > template page (http://bibdesk.sourceforge.net/manual/BibDesk% > 20Help_54.html#SEC109 > ) or as the first section under it. > > 2. I think it would be helpful if the overview listed all the pages > available in the template section with brief descriptions. For > example, knowledge of the template keys is essential to writing or > modifying templates, but to find a listing of the keys you need to > traverse links from the top template page, to the "customizing > templates" page to the "template tags appendix" page and finally, find > the link to the template keys page at the very bottom of the template > tags appendix. As an alternative, it might help to list the subpages > on the top templates section page, in outline form under the main > pages that are currently listed there. > > 3. The template keys list has very few descriptions entered for the > keys. It's not always completely apparent what strings the keys will > produce based on their names, particularly if you're just starting > with templates. Descriptions/examples would help a lot. > > By the way, the new template editor is an excellent start toward > putting the power of the templating system into the hands of regular > folks. > > Best wishes, > > Jim Harrison > Univ. of Virginia
As always, we're happy to receive contributions, in particular to the help ;-) Christiaan ------------------------------------------------------------------------- SF.Net email is sponsored by: The Future of Linux Business White Paper from Novell. From the desktop to the data center, Linux is going mainstream. Let it simplify your IT future. http://altfarm.mediaplex.com/ad/ck/8857-50307-18918-4 _______________________________________________ Bibdesk-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/bibdesk-users
