qtbase/doc/global/htmltabs.qdocconf
Topi Reinio f490b4de05 Doc: Clean up output for tabbed content macro
Insert line breaks in the content the \tab macro expands to. This
produces nicer-looking html and also fixes an issue related to
the post-processing done to the generated files.

Fixes: QTWEBSITE-1202
Pick-to: 6.8
Change-Id: If4e7f7242f8687ef84ad715744653c4167cf907f
Reviewed-by: Andreas Eliasson <andreas.eliasson@qt.io>
(cherry picked from commit 88e4e952d73db9bc442593a96c88ca22ba7ab673)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
2025-02-08 08:08:41 +00:00

61 lines
1.9 KiB
Plaintext

#Macros for HTML tabs
#Usage:
#\tab {name}{tab-id}{title}{checked}
#\tabcontent {tab-id}
# content
#\endtabcontent
# Ensure that the {name} is unique for the group.
# i.e A group of tabs can have the same name, whereas
# {tab-id} should be unique. In addition, the argument
# for \tabcontent macro should match the {tab-id} for the
# corresponding \tab.
# The {checked} argument ensures that the tab is selected
# by default when the HTML page is loaded. For the other
# tabs that are not selected, pass and empty argument {}.
#
# Note that these macros work with the online template only.
#
# Example:
# \if defined(onlinedocs)
# \tab {build-qt-app}{tab-cmake}{CMake}{checked}
# \tab {build-qt-app}{tab-qmake}{qmake}{}
# \tabcontent {tab-cmake}
# \else
# \section1 Using CMake
# \endif
# CMake-specific instructions go here
# \if defined(onlinedocs)
# \endtabcontent
# \tabcontent {tab-qmake}
# \else
# \section1 Using qmake
# \endif
# qmake-specific instructions go here
# \if defined(onlinedocs)
# \endtabcontent
# \endif
macro.tab.HTML = "<input type=\"radio\" name=\"tabs_\1\" id=\"\2\" \4/><label for=\"\2\">\3</label>\n<style>#\2:checked ~ .\2{display: block;}</style>\n"
macro.tabcontent = "\\div {class=\"tabcontent \1\"}"
macro.endtabcontent = "\\enddiv"
HTML.extraimages += template/style/htmltabs.css
HTML.headerstyles += \
" <link rel=\"stylesheet\" type=\"text/css\" href=\"images/htmltabs.css\" />\n"
HTML.headerscripts += \
" <script type=\"text/javascript\">\n" \
" \$(document).ready(function(){\n" \
" \$(\"input[type=radio]\").on(\"click\", function() {\n" \
" var lbl = \$(this).next().text();\n" \
" \$(\"input[type=radio]:not(checked)\").filter(function() {\n" \
" if (\$(this).next().text() == lbl)\n" \
" \$(this).prop(\"checked\", true);\n" \
" });\n" \
" });\n" \
" });\n" \
" </script>\n"