# 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

# start_docs_page() starts a documentation page with the specified title
subroutine(start_docs_page(string title), (
  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
  string fullOptionName = get_node_name_from_shortcut(option);

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

  # Get the option label
  string label = $("lang_options." . optionNameForURL . ".label");

  string result = expand("<a href=\"?dp+docs.option+webvars.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_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

# 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