APIDoc 4.0 introduce un sistema dinámico de temas de highlight.js que permite personalizar el resaltado de sintaxis con más de 160 temas disponibles.
highlightTheme en apidoc.jsonAgrega el campo highlightTheme a tu apidoc.json:
{
"name": "Mi Documentación API",
"version": "1.0.0",
"description": "Documentación con resaltado personalizado",
"highlightTheme": "tokyo-night-dark",
"title": "Mi API"
}
{"highlightTheme": "tokyo-night-dark"} // Tema oscuro moderno (predeterminado)
{"highlightTheme": "github-dark"} // Tema oscuro de GitHub
{"highlightTheme": "monokai"} // Clásico Monokai
{"highlightTheme": "dracula"} // Popular tema Dracula
{"highlightTheme": "androidstudio"} // Tema Android Studio
{"highlightTheme": "vs2015"} // Visual Studio 2015
{"highlightTheme": "tomorrow-night"} // Tomorrow Night
{"highlightTheme": "gruvbox-dark"} // Gruvbox oscuro
{"highlightTheme": "github"} // Tema claro de GitHub
{"highlightTheme": "vs"} // Visual Studio claro
{"highlightTheme": "atom-one-light"} // Atom One Light
{"highlightTheme": "xcode"} // Tema Xcode
{"highlightTheme": "tomorrow"} // Tomorrow claro
{"highlightTheme": "foundation"} // Foundation
{"highlightTheme": "lightfair"} // Light Fair
{"highlightTheme": "rainbow"} // Arcoíris colorido
{"highlightTheme": "magula"} // Magula vibrante
{"highlightTheme": "sunburst"} // Sunburst brillante
{"highlightTheme": "hybrid"} // Hybrid colorido
// Cambiar tema dinámicamente (función disponible globalmente)
window.loadHighlightTheme('dracula');
window.loadHighlightTheme('github-dark');
window.loadHighlightTheme('monokai');
github, github-dark, github-dark-dimmedmonokai, dracula, tomorrow-night, solarized-dark, solarized-lighttokyo-night-dark, tokyo-night-light, nord, gruvbox-dark, gruvbox-lightvs, vs2015, androidstudio, xcode, idea, intellij-lightdefault, lightfair, far, foundation, asceticbrown-paper, school-book, old-school, pojoaquerainbow, magula, sunburst, hybrid, kimbie-dark, kimbie-lightarta, codepen-embed, color-brewer, dark, darkula, doccofar, felipec, foundation, github-gist, gml, googlecodegradient-dark, grayscale, hopscotch, ir-black, isbl-editor-darkisbl-editor-light, kimbie-dark, kimbie-light, lightfair, lioshimagula, mono-blue, monokai-sublime, night-owl, nnfx-darknnfx-light, nord, obsidian, ocean, paraiso-dark, paraiso-lightpurebasic, qtcreator-dark, qtcreator-light, railscasts, rainbowrouteros, shades-of-purple, srcery, stackoverflow-darkstackoverflow-light, sunburst, tokyo-night-dark, tokyo-night-lighttomorrow, tomorrow-night-blue, tomorrow-night-brighttomorrow-night-eighties, a11y-dark, a11y-light, agate, an-old-hopeatom-one-dark, atom-one-dark-reasonable, atom-one-light, base16brown-paper, codepen-embed, color-brewer, darkula, defaulttokyo-night-dark incluido en el CSS principal (391KB)assets/highlight-themes/# Los temas se procesan automáticamente durante la construcción
npm run build
# Para desarrollo local
npm run build:example
Si estabas usando un tema personalizado de highlight.js en v3.x:
"highlightTheme": "nombre-del-tema" a apidoc.jsonEl nuevo sistema es más eficiente y maneja automáticamente los conflictos de temas.
assets/highlight-themes/github, vs, atom-one-lightgithub-dark, vs2015, tokyo-night-darkgithub, default, foundationgithub-dark, monokai, draculaxcode, atom-one-light, foundationtomorrow-night, nord, gruvbox-darkrainbow, sunburst, magula, hybridgithub-darkdefault (~2KB)tokyo-night-dark (~8KB)El sistema de temas de APIDoc 4.0 te permite crear documentación visualmente atractiva con el resaltado de código perfecto para tu marca y audiencia. ¡Experimenta con diferentes temas para encontrar el que mejor se adapte a tu proyecto!