# TRANSLATORS: Tranlate the values in quotes
volatile.q_label = "Q"; # appears before questions as Q:
volatile.a_label = "A"; # appears before answers as A:

# NO TRANSLATION NEEDED BEYOND THIS POINT

# KHP 18/Aug/2010 - added base_util, required by get_current_language()
include "templates.util.base_util";

# docs_user_chapter_link() returns a link to an option documentation page in the user guide, given the shortcut or option name
subroutine(docs_user_chapter_link(string chapter), (

  expand("<a href=\"?dp+docs.user_guide.$chapter\">");
  $("docs.user_guide.page_titles." . chapter);
  "</a>";

)); # docs_user_chapter_link


# start_docs_page() starts a documentation page with the specified title
subroutine(start_docs_page(string title), (

  # KHP 06/Sep/2010 - Set output language
  string user_node_name = node_name(volatile.authenticated_user_node_path);
  string current_language = get_current_language(user_node_name);
  set_language(current_language);
  
  # debug_message("#### start_docs_page() - user_node_name: " . user_node_name . "\n");
  # debug_message("#### start_docs_page() - current_language: " . current_language . "\n");

  volatile.docs_page_title = title;
#debug_message("volatile.docs_page_title: " . volatile.docs_page_title . "\n");
  docs.header;
  '<table border="0" cellpadding="0" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="700">\n';
  "  <tr>\n";
  expand('    <td colspan="2" align="center" bgcolor="#99AEC5" width="100%"><span class=docspagetitle>' . title . '</span></td>\n');
  "  </tr>\n";
  "</table>\n";

  '<table border="0" cellpadding="0" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="700">\n';
  "  <tr>\n";
  "    <td>\n";
 

	if (internal.docs.tab eq 'USER') and (internal.docs.index eq 'FALSE') then (
	
		'<br>';
		'<table border=0 width=700 bordercolor=#FFFFFF>';
		'<tr bordercolor=#CCCCCC><td><p align=center>';
		'<img src="' . fileref('picts/docs/user_guide/menu_leaf_selected.gif') . '">';
		docs_user_chapter_link('index') . '<img src="' . fileref('picts/docs/user_guide/menu_leaf_selected.gif') . '">'; 
		docs_user_chapter_link('user_overview') . '<img src="' . fileref('picts/docs/user_guide/menu_leaf_selected.gif') . '">';
		docs_user_chapter_link('user_reports') . '<img src="' . fileref('picts/docs/user_guide/menu_leaf_selected.gif') . '">';
		docs_user_chapter_link('user_filters') . '<img src="' . fileref('picts/docs/user_guide/menu_leaf_selected.gif') . '">';
		docs_user_chapter_link('user_interpreting_reports') . '<img src="' . fileref('picts/docs/user_guide/menu_leaf_selected.gif') . '">';
		'</p></td></tr></table>';		
	)
	else (
	
		'<br>';
	);
));

subroutine(end_docs_page, (
  "    </td>\n";
  "  </tr>\n";
  "</table>\n";
  docs.footer;
));

# docs_option_link() returns a link to an option documentation page, given the shortcut or option name
subroutine(docs_option_link(string option), (

  # Get the full node name for this option
#  echo("option: " . option);
  string fullOptionName;
  if (node_exists("default_profile." . option)) then
    fullOptionName = "default_profile." . option;
  else if (node_exists(option)) then
    fullOptionName = option;

  # 2011-09-26: If it's a subnode of log source, use the option path as the full option name (it's in "default" in default_profile, but not in lang_options).
  else if (matches_regular_expression(option, "^default_profile[.]log[.]source[.](.*)$")) then
    fullOptionName = option;

  else
    fullOptionName = get_node_name_from_shortcut(option);
#  echo("fullOptionName: " . fullOptionName);

  # Get the option name within the profile
  string optionNameForURL = fullOptionName;
  if (starts_with(fullOptionName, "default_profile.")) then
    optionNameForURL = "profile." . substr(optionNameForURL, length("default_profile."));

  # Get the option label
  string label;
  if (optionNameForURL ne "") then
    label = $("lang_options." . optionNameForURL . ".label");
  else
    label = "[unknown]";

  string result = expand("<a href=\"?dp=docs.option&amp;option_name=$optionNameForURL\">$label</a>");
  result;

)); # docs_option_link

# remove_prefix() -- this removes a prefix p from string s
subroutine(remove_prefix(string s, string p), (
  if (starts_with(s, p)) then
    s = substr(s, length(p));
  s;
));

# docs_chapter_link() returns a link to an option documentation page, given the shortcut or option name
subroutine(docs_chapter_link(string chapter), (

  expand("<a href=\"?dp+docs.technical_manual.$chapter\">");
  $("docs.technical_manual.page_titles." . chapter);
  "</a>";

)); # docs_chapter_link

# docs_chapter_link_with_anchor() returns a link to an option documentation page, given the shortcut or option name
subroutine(docs_chapter_link_with_anchor(string chapter, string anchor, string label), (

  expand("<a href=\"?dp+docs.technical_manual.$chapter#$anchor\">");
  label;
  "</a>";

)); # docs_chapter_link_with_anchor

# docs_function_link() returns a link to a Salang function
subroutine(docs_function_link(string function), (

  "<a href=\"?dp+docs.technical_manual.salang#" . function . "\">";
  "<code>" . function . "()</code>";
  "</a>";

)); # docs_function


# docs_faq_link() returns a link to an FAQ entry, given the name
subroutine(docs_faq_link(string name), (

  expand("<a href=\"?dp+docs.faq.entry+webvars.entry+$name\">");
  $("docs.faq.db." . name . ".label");
  "</a>";

)); # docs_faq_link

# docs_user_faq_link() returns a link to an FAQ entry in the User FAQ, given the name
subroutine(docs_user_faq_link(string name), (

  expand("<a href=\"?dp+docs.user_faq.entry+webvars.entry+$name\">");
  $("docs.user_faq.db." . name . ".label");
  "</a>";

)); # docs_user_faq_link

# docs_faq_short_description() returns a short description of a FAQ entry
subroutine(docs_faq_short_description(string name), (

  expand("<b>$volatile.q_label</b>: ") . $("docs.faq.db." . name . ".question") . "<br>\n";
  expand("<b>$volatile.a_label</b>: ") . $("docs.faq.db." . name . ".short_answer") . "\n";
  "For full details, see " . docs_faq_link(name) . ".<br>\n";
  "<br>\n";

)); # docs_faq_short_description

# docs_user_faq_short_description() returns a short description of a FAQ entry from the User FAQ
subroutine(docs_user_faq_short_description(string name), (

  expand("<b>$volatile.q_label</b>: ") . $("docs.user_faq.db." . name . ".question") . "<br>\n";
  expand("<b>$volatile.a_label</b>: ") . $("docs.user_faq.db." . name . ".short_answer") . "\n";
  "For full details, see " . docs_user_faq_link(name) . ".<br>\n";
  "<br>\n";

)); # docs_user_faq_short_description