temerity uh-MER-uh-tee, noun: Unreasonable or foolhardy contempt of danger; rashness.   SourceForge
or possibly this project....


About US:
  • Home 
  • Who We Want To Thank 
  • Goals 
  • FAQ 
  • Other Open Source Projects 
  • Contact US 
  • Found A Bug? 

  • Temerity Links:
  • News 
  • Guide To Writing Your Own Theme 
  • Take A Tour 
  • Download 
  • Documentation 
  • Changelog 

  • Basically this is how the themes are structured in 2.x:
    all themes go into temerity_themes/themename/
    the only required files in there are -
  • error.html
  • index.html
  • input_form.html
  • output_info.html
  • And one for each module (When I write this the following pages are required)
  • account_reset.html
  • get_user_info.html
  • vacation_message.html
  • change_password.html
  • make_web_directory.html
  • setup_forward.html

  • input_form.html is merely the html that surrounds the forms.
    output_info.html is merely the html that surrounds the success information.
    These are kept seperate so that you have more options

    error.html is the page you are thrown to if there is an error

    Next up are the files for creating forms and providing output namely those for the modules
    What makes these special?

  • Each file is named after an existing module
  • Each file has the text of the form within it surrounded by <INPUT_FORM> and </INPUT_FORM>
  • Each file has the text of the output within it surrounded by <OUTPUT_INFO> and </OUTPUT_INFO>
  • Inside of <INPUT_FORM> and <OUTPUT_INFO> there is a <PAGE_TITLE> tag
    which has within it the code to title the page (Example <PAGE_TITLE><title>Page Title</title> )
  • The FIRST line of every file contains the text <!---META: cat --!> This tells temerity that the module this html is a part of belongs in the catagory "cat"
  • There are also entries known as $username $forward_to $vacation_message $on_off $quota with obvious values
  • $AUTHORITIES is really only used in error.html, but can be put anywhere. it will tell people who to contact if there is a problem
  • $last is for get_user_info.cgi's reporting of when a user last logged in
  • $flush_mail is for account_reset.cgi's reporting if it flushed the user's mail queue
  • $reset_account is for account_reset.cgi's reporting if it deleted most of the users dot files
  • $PUBLIC_HTML is for telling make_web_directory.cgi what the public_html directory (or equivalent) is named so it can tell the user
  • Ways to account for frequent changes:
    Forms
  • Any time you want to refer back to the perl script insert the text $this_file (since each module calls itself once it has post data you will need this)
  • Part of the form is to allow for hosts to be picked, insert $host_pull_menu where applicable
  • Input, Output, Index
  • $page_title is for having the module (from above) set the page title
  • $theme_www is for refferencing images, stylesheets, or really anything inside of the theme directory from the web
  • $text is where the guts will be put into the form/output
  • $temerity_www is for directly refferencing any module (usually index) via the web.
  • That is a basic guide to how the theming works. There is probably some stuff left off here, but I can't think of what right now. If you find something that needs more explaining or something, just let me know! (Check the contact page for current contact info)

     
    Temerity Administration Toolkit