From 2943e14b6d59880eed6f6b6a2ab8cb2da889b31d Mon Sep 17 00:00:00 2001 From: Adolfo Fitoria Date: Wed, 12 Oct 2011 13:09:03 -0300 Subject: updated documentation for skin customization --- askbot/doc/source/customizing-skin-in-askbot.rst | 90 ++++++++++++++++++++++++ 1 file changed, 90 insertions(+) diff --git a/askbot/doc/source/customizing-skin-in-askbot.rst b/askbot/doc/source/customizing-skin-in-askbot.rst index 686fc3ed..d54e2ee6 100644 --- a/askbot/doc/source/customizing-skin-in-askbot.rst +++ b/askbot/doc/source/customizing-skin-in-askbot.rst @@ -198,3 +198,93 @@ These are not set in stone yet. | /faq/ | | | /feedback/ | | +----------------------------+------------------------+ + +Template Distrubution. +====================== + +The general template layout is controlled by a few files described below: + ++------------------------------------+------------------------------------------------------+ +| Template File | Description | ++====================================+======================================================+ +| blocks/answer_edit_tips.html | Contains text displayed as "Answer Edit Tips" in the | +| | answer edit page. | ++------------------------------------+------------------------------------------------------+ +| blocks/ask_form.html | Contains the form to ask a question. | ++------------------------------------+------------------------------------------------------+ +| blocks/bottom_scripts.html | Contains javascript calls and some javascript | +| | functions needed for askbot this is included at the | +| | bottom of every page. | ++------------------------------------+------------------------------------------------------+ +| blocks/editor_data.html | Contains data necessary for the post editor this is | +| | included in block endjs. | ++------------------------------------+------------------------------------------------------+ +| blocks/footer.html | Contains the html displayed on the footer. | ++------------------------------------+------------------------------------------------------+ +| blocks/header.html | Contains the header section of the web. Normaly | +| | includes the site logo and navitation tools. | ++------------------------------------+------------------------------------------------------+ +| blocks/input_bar.html | Contains the search bar. | ++------------------------------------+------------------------------------------------------+ +| blocks/mandatory_tags_js.html | | ++------------------------------------+------------------------------------------------------+ +| blocks/paginator.html | Renders the paginator in the main page. | ++------------------------------------+------------------------------------------------------+ +| blocks/question_edit_tips.html | Contains text displayed as "Question Edit Tips" in | +| | the question edit page. | ++------------------------------------+------------------------------------------------------+ +| blocks/secondary_header.html | Containter for the search bar section. | ++------------------------------------+------------------------------------------------------+ +| blocks/system_messages.html | Containter for notification messages in the top of | +| | the page. | ++------------------------------------+------------------------------------------------------+ +| blocks/user_navigation.html | User links to login/logout. | ++------------------------------------+------------------------------------------------------+ + +According to the URL some template files are called, the detail on +which file is called is in the following table. + ++----------------------------+-----------------------------+--------------------------------+ +| Page url | Template file | Macros used | ++============================+=============================+================================+ +| /questions/ | | | ++----------------------------+-----------------------------+--------------------------------+ +| /questions/ask/ | ask.html | | ++----------------------------+-----------------------------+--------------------------------+ +| /tags | tags.html | tag_widget, paginator, | +| | | tag_cloud | ++----------------------------+-----------------------------+--------------------------------+ +| /question// | question.html | tag_widget, edit_post | +| | | checkbox_in_div, share | ++----------------------------+-----------------------------+--------------------------------+ +| /questions//revisions | revisions.html | post_contributor_info | ++----------------------------+-----------------------------+--------------------------------+ +| /questions//edit | question-edit.html | tag_autocomplete_js, | +| | | checkbox_in_div, | +| | | edit_post | ++----------------------------+-----------------------------+--------------------------------+ +| /answers//revisions | revisions.html | post_contributor_info | ++----------------------------+-----------------------------+--------------------------------+ +| /users/ | users.html | users_list, paginator | ++----------------------------+-----------------------------+--------------------------------+ +| /users//slug | user_profile/user.html | | ++----------------------------+-----------------------------+--------------------------------+ +| /users//edit (bug!) | user_profile/user_edit.html | gravatar | ++----------------------------+-----------------------------+--------------------------------+ +| /account/signin/ | authopenid/signin.html | provider_buttons | +| | | (from authopenid/macros) | ++----------------------------+-----------------------------+--------------------------------+ +| /avatar/change/ | avatar/change.html | gravatar | ++----------------------------+-----------------------------+--------------------------------+ +| /about/ | about.html | | ++----------------------------+-----------------------------+--------------------------------+ +| /badges/ | badges.html | | ++----------------------------+-----------------------------+--------------------------------+ +| /badges// | badge.html | user_score_and_badge_summary | ++----------------------------+-----------------------------+--------------------------------+ +| /account/logout/ | authopenid/logout.html | | ++----------------------------+-----------------------------+--------------------------------+ +| /faq/ | faq.html | | ++----------------------------+-----------------------------+--------------------------------+ +| /feedback/ | feedback.html | | ++----------------------------+-----------------------------+--------------------------------+ -- cgit v1.2.3-1-g7c22