Merge pull request #10621 from mshabunin:disable-docs
Documentation generation refactoring (#10621) * Documentation build updates: - disable documentation by default, do not add to ALL target - combine Doxygen and Javadoc - optimize Doxygen html * javadoc: fix path in build directory * cmake: fix "Documentation" status linepull/10637/head
parent
ec353dbdda
commit
1b0ff57562
11 changed files with 201 additions and 172 deletions
@ -0,0 +1,98 @@ |
||||
function getLabelName(innerHTML) { |
||||
var str = innerHTML.toLowerCase(); |
||||
// Replace all '+' with 'p'
|
||||
str = str.split('+').join('p'); |
||||
// Replace all ' ' with '_'
|
||||
str = str.split(' ').join('_'); |
||||
// Replace all '#' with 'sharp'
|
||||
str = str.split('#').join('sharp'); |
||||
// Replace other special characters with 'ascii' + code
|
||||
for (var i = 0; i < str.length; i++) { |
||||
var charCode = str.charCodeAt(i); |
||||
if (!(charCode == 95 || (charCode > 96 && charCode < 123) || (charCode > 47 && charCode < 58))) |
||||
str = str.substr(0, i) + 'ascii' + charCode + str.substr(i + 1); |
||||
} |
||||
return str; |
||||
} |
||||
|
||||
function addToggle() { |
||||
var $getDiv = $('div.newInnerHTML').last(); |
||||
var buttonName = $getDiv.html(); |
||||
var label = getLabelName(buttonName.trim()); |
||||
$getDiv.attr("title", label); |
||||
$getDiv.hide(); |
||||
$getDiv = $getDiv.next(); |
||||
$getDiv.attr("class", "toggleable_div label_" + label); |
||||
$getDiv.hide(); |
||||
} |
||||
|
||||
function addButton(label, buttonName) { |
||||
var b = document.createElement("BUTTON"); |
||||
b.innerHTML = buttonName; |
||||
b.setAttribute('class', 'toggleable_button label_' + label); |
||||
b.onclick = function() { |
||||
$('.toggleable_button').css({ |
||||
border: '2px outset', |
||||
'border-radius': '4px' |
||||
}); |
||||
$('.toggleable_button.label_' + label).css({ |
||||
border: '2px inset', |
||||
'border-radius': '4px' |
||||
}); |
||||
$('.toggleable_div').css('display', 'none'); |
||||
$('.toggleable_div.label_' + label).css('display', 'block'); |
||||
}; |
||||
b.style.border = '2px outset'; |
||||
b.style.borderRadius = '4px'; |
||||
b.style.margin = '2px'; |
||||
return b; |
||||
} |
||||
|
||||
function buttonsToAdd($elements, $heading, $type) { |
||||
if ($elements.length === 0) { |
||||
$elements = $("" + $type + ":contains(" + $heading.html() + ")").parent().prev("div.newInnerHTML"); |
||||
} |
||||
var arr = jQuery.makeArray($elements); |
||||
var seen = {}; |
||||
arr.forEach(function(e) { |
||||
var txt = e.innerHTML; |
||||
if (!seen[txt]) { |
||||
$button = addButton(e.title, txt); |
||||
if (Object.keys(seen).length == 0) { |
||||
var linebreak1 = document.createElement("br"); |
||||
var linebreak2 = document.createElement("br"); |
||||
($heading).append(linebreak1); |
||||
($heading).append(linebreak2); |
||||
} |
||||
($heading).append($button); |
||||
seen[txt] = true; |
||||
} |
||||
}); |
||||
return; |
||||
} |
||||
|
||||
function addTutorialsButtons() { |
||||
$("h2").each(function() { |
||||
$heading = $(this); |
||||
$smallerHeadings = $(this).nextUntil("h2").filter("h3").add($(this).nextUntil("h2").find("h3")); |
||||
if ($smallerHeadings.length) { |
||||
$smallerHeadings.each(function() { |
||||
var $elements = $(this).nextUntil("h2,h3").filter("div.newInnerHTML"); |
||||
buttonsToAdd($elements, $(this), "h3"); |
||||
}); |
||||
} else { |
||||
var $elements = $(this).nextUntil("h2").filter("div.newInnerHTML"); |
||||
buttonsToAdd($elements, $heading, "h2"); |
||||
} |
||||
}); |
||||
$(".toggleable_button").first().click(); |
||||
var $clickDefault = $('.toggleable_button.label_python').first(); |
||||
if ($clickDefault.length) { |
||||
$clickDefault.click(); |
||||
} |
||||
$clickDefault = $('.toggleable_button.label_cpp').first(); |
||||
if ($clickDefault.length) { |
||||
$clickDefault.click(); |
||||
} |
||||
return; |
||||
} |
Loading…
Reference in new issue