diff --git a/pr-preview/pr-13/_/css/site.css b/pr-preview/pr-13/_/css/site.css deleted file mode 100644 index c39da22..0000000 --- a/pr-preview/pr-13/_/css/site.css +++ /dev/null @@ -1,2608 +0,0 @@ -@font-face { - font-family: Roboto; - font-style: normal; - font-weight: 400; - src: url(../font/roboto-latin-400-normal.woff2) format("woff2"), url(../font/roboto-latin-400-normal.woff) format("woff"); - unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da, U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215, U+feff, U+fffd -} - -@font-face { - font-family: Roboto; - font-style: italic; - font-weight: 400; - src: url(../font/roboto-latin-400-italic.woff2) format("woff2"), url(../font/roboto-latin-400-italic.woff) format("woff"); - unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da, U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215, U+feff, U+fffd -} - -@font-face { - font-family: Roboto; - font-style: normal; - font-weight: 500; - src: url(../font/roboto-latin-500-normal.woff2) format("woff2"), url(../font/roboto-latin-500-normal.woff) format("woff"); - unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da, U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215, U+feff, U+fffd -} - -@font-face { - font-family: Roboto; - font-style: italic; - font-weight: 500; - src: url(../font/roboto-latin-500-italic.woff2) format("woff2"), url(../font/roboto-latin-500-italic.woff) format("woff"); - unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da, U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215, U+feff, U+fffd -} - -@font-face { - font-family: Roboto Mono; - font-style: normal; - font-weight: 400; - src: url(../font/roboto-mono-latin-400-normal.woff2) format("woff2"), url(../font/roboto-mono-latin-400-normal.woff) format("woff"); - unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da, U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215, U+feff, U+fffd -} - -@font-face { - font-family: Roboto Mono; - font-style: normal; - font-weight: 500; - src: url(../font/roboto-mono-latin-500-normal.woff2) format("woff2"), url(../font/roboto-mono-latin-500-normal.woff) format("woff"); - unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da, U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215, U+feff, U+fffd -} - -*, -::after, -::before { - -webkit-box-sizing: inherit; - box-sizing: inherit -} - -html { - -webkit-box-sizing: border-box; - box-sizing: border-box; - font-size: 1.0625em; - height: 100%; - scroll-behavior: smooth -} - -@media screen and (min-width:1024px) { - html { - font-size: 1.125em - } -} - -body { - background: #fff; - color: #222; - font-family: Roboto, sans-serif; - line-height: 1.15; - margin: 0; - -moz-tab-size: 4; - -o-tab-size: 4; - tab-size: 4; - word-wrap: anywhere -} - -a { - text-decoration: none -} - -a:hover { - text-decoration: underline -} - -a:active { - background-color: none -} - -code, -kbd, -pre { - font-family: Roboto Mono, monospace -} - -b, -dt, -strong, -th { - font-weight: 500 -} - -sub, -sup { - font-size: 75%; - line-height: 0; - position: relative; - vertical-align: baseline -} - -sub { - bottom: -.25em -} - -sup { - top: -.5em -} - -em em { - font-style: normal -} - -strong strong { - font-weight: 400 -} - -button { - cursor: pointer; - font-family: inherit; - font-size: 1em; - line-height: 1.15; - margin: 0 -} - -button::-moz-focus-inner { - border: none; - padding: 0 -} - -summary { - cursor: pointer; - -webkit-tap-highlight-color: transparent; - outline: none -} - -table { - border-collapse: collapse; - word-wrap: normal -} - -object[type="image/svg+xml"]:not([width]) { - width: -webkit-fit-content; - width: -moz-fit-content; - width: fit-content -} - -::-webkit-input-placeholder { - opacity: .5 -} - -::-moz-placeholder { - opacity: .5 -} - -:-ms-input-placeholder { - opacity: .5 -} - -::-ms-input-placeholder { - opacity: .5 -} - -::placeholder { - opacity: .5 -} - -@media (pointer:fine) { - @supports (scrollbar-width:thin) { - html { - scrollbar-color: #c1c1c1 #fafafa - } - - body * { - scrollbar-width: thin; - scrollbar-color: #c1c1c1 transparent - } - } - - html::-webkit-scrollbar { - background-color: #fafafa; - height: 12px; - width: 12px - } - - body ::-webkit-scrollbar { - height: 6px; - width: 6px - } - - ::-webkit-scrollbar-thumb { - background-clip: padding-box; - background-color: #c1c1c1; - border: 3px solid transparent; - border-radius: 12px - } - - body ::-webkit-scrollbar-thumb { - border-width: 1.75px; - border-radius: 6px - } - - ::-webkit-scrollbar-thumb:hover { - background-color: #9c9c9c - } -} - -@media screen and (min-width:1024px) { - .body { - display: -webkit-box; - display: -ms-flexbox; - display: flex - } -} - -.nav-container { - position: fixed; - top: 3.5rem; - left: 0; - width: 100%; - font-size: .94444rem; - z-index: 1; - visibility: hidden -} - -@media screen and (min-width:769px) { - .nav-container { - width: 15rem - } -} - -@media screen and (min-width:1024px) { - .nav-container { - font-size: .86111rem; - -webkit-box-flex: 0; - -ms-flex: none; - flex: none; - position: static; - top: 0; - visibility: visible - } -} - -.nav-container.is-active { - visibility: visible -} - -.nav { - background: #fafafa; - position: relative; - top: 2.5rem; - height: calc(100vh - 6rem) -} - -@media screen and (min-width:769px) { - .nav { - -webkit-box-shadow: .5px 0 3px #c1c1c1; - box-shadow: .5px 0 3px #c1c1c1 - } -} - -@media screen and (min-width:1024px) { - .nav { - top: 3.5rem; - -webkit-box-shadow: none; - box-shadow: none; - position: sticky; - height: calc(100vh - 3.5rem) - } -} - -.nav a { - color: inherit -} - -.nav .panels { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; - height: inherit -} - -html.is-clipped--nav { - overflow-y: hidden -} - -.nav-panel-menu { - overflow-y: scroll; - -ms-scroll-chaining: none; - overscroll-behavior: none; - height: calc(100% - 2.5rem) -} - -.nav-panel-menu:not(.is-active) .nav-menu { - opacity: .75 -} - -.nav-panel-menu:not(.is-active)::after { - content: ""; - background: rgba(0, 0, 0, .5); - display: block; - position: absolute; - top: 0; - right: 0; - bottom: 0; - left: 0 -} - -.nav-menu { - min-height: 100%; - padding: .5rem .75rem; - line-height: 1.35; - position: relative -} - -.nav-menu h3.title { - color: #424242; - font-size: inherit; - font-weight: 500; - margin: 0; - padding: .25em 0 .125em -} - -.nav-list { - list-style: none; - margin: 0 0 0 .75rem; - padding: 0 -} - -.nav-menu>.nav-list+.nav-list { - margin-top: .5rem -} - -.nav-item { - margin-top: .5em -} - -.nav-item-toggle~.nav-list { - padding-bottom: .125rem -} - -.nav-item[data-depth="0"]>.nav-list:first-child { - display: block; - margin: 0 -} - -.nav-item:not(.is-active)>.nav-list { - display: none -} - -.nav-item-toggle { - background: transparent url(../img/caret.svg) no-repeat 50%/50%; - border: none; - outline: none; - line-height: inherit; - padding: 0; - position: absolute; - height: 1.35em; - width: 1.35em; - margin-top: -.05em; - margin-left: -1.35em -} - -.nav-item.is-active>.nav-item-toggle { - -webkit-transform: rotate(90deg); - transform: rotate(90deg) -} - -.is-current-page>.nav-link, -.is-current-page>.nav-text { - font-weight: 500 -} - -.nav-panel-explore { - background: #fafafa; - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; - position: absolute; - top: 0; - right: 0; - bottom: 0; - left: 0 -} - -.nav-panel-explore:not(:first-child) { - top: auto; - max-height: calc(50% + 2.5rem) -} - -.nav-panel-explore .context { - font-size: .83333rem; - -ms-flex-negative: 0; - flex-shrink: 0; - color: #5d5d5d; - -webkit-box-shadow: 0 -1px 0 #e1e1e1; - box-shadow: 0 -1px 0 #e1e1e1; - padding: 0 .5rem; - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; - -webkit-box-pack: justify; - -ms-flex-pack: justify; - justify-content: space-between; - line-height: 1; - height: 2.5rem -} - -.nav-panel-explore:not(:first-child) .context { - cursor: pointer -} - -.nav-panel-explore .context .version { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-align: inherit; - -ms-flex-align: inherit; - align-items: inherit -} - -.nav-panel-explore .context .version::after { - content: ""; - background: url(../img/chevron.svg) no-repeat 100%/auto 100%; - width: 1.25em; - height: .75em -} - -.nav-panel-explore .components { - line-height: 1.6; - -webkit-box-flex: 1; - -ms-flex-positive: 1; - flex-grow: 1; - -webkit-box-shadow: inset 0 1px 5px #e1e1e1; - box-shadow: inset 0 1px 5px #e1e1e1; - background: #f0f0f0; - padding: .5rem .75rem 0; - margin: 0; - overflow-y: scroll; - -ms-scroll-chaining: none; - overscroll-behavior: none; - max-height: 100%; - display: block -} - -.nav-panel-explore:not(.is-active) .components { - display: none -} - -.nav-panel-explore .component { - display: block -} - -.nav-panel-explore .component+.component { - margin-top: .5rem -} - -.nav-panel-explore .component:last-child { - margin-bottom: .75rem -} - -.nav-panel-explore .component .title { - font-weight: 500 -} - -.nav-panel-explore .versions { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -ms-flex-wrap: wrap; - flex-wrap: wrap; - padding-left: 0; - margin-top: -.25rem; - line-height: 1; - list-style: none -} - -.nav-panel-explore .component .version { - margin: .375rem .375rem 0 0 -} - -.nav-panel-explore .component .version a { - border: 1px solid #c1c1c1; - border-radius: .25rem; - opacity: .75; - white-space: nowrap; - padding: .125em .25em; - display: inherit -} - -.nav-panel-explore .component .is-current a { - border-color: currentColor; - opacity: .9; - font-weight: 500 -} - -@media screen and (max-width:1023.5px) { - aside.toc.sidebar { - display: none - } - - main>.content { - overflow-x: auto - } -} - -@media screen and (min-width:1024px) { - main { - -webkit-box-flex: 1; - -ms-flex: auto; - flex: auto; - min-width: 0 - } - - main>.content { - display: -webkit-box; - display: -ms-flexbox; - display: flex - } - - aside.toc.embedded { - display: none - } - - aside.toc.sidebar { - -webkit-box-flex: 0; - -ms-flex: 0 0 9rem; - flex: 0 0 9rem; - -webkit-box-ordinal-group: 2; - -ms-flex-order: 1; - order: 1 - } -} - -@media screen and (min-width:1216px) { - aside.toc.sidebar { - -ms-flex-preferred-size: 12rem; - flex-basis: 12rem - } -} - -.toolbar { - color: #5d5d5d; - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; - background-color: #fafafa; - -webkit-box-shadow: 0 1px 0 #e1e1e1; - box-shadow: 0 1px 0 #e1e1e1; - display: -webkit-box; - display: -ms-flexbox; - display: flex; - font-size: .83333rem; - height: 2.5rem; - -webkit-box-pack: start; - -ms-flex-pack: start; - justify-content: flex-start; - position: sticky; - top: 3.5rem; - z-index: 2 -} - -.toolbar a { - color: inherit -} - -.nav-toggle { - background: url(../img/menu.svg) no-repeat 50% 47.5%; - background-size: 49%; - border: none; - outline: none; - line-height: inherit; - padding: 0; - height: 2.5rem; - width: 2.5rem; - margin-right: -.25rem -} - -@media screen and (min-width:1024px) { - .nav-toggle { - display: none - } -} - -.nav-toggle.is-active { - background-image: url(../img/back.svg); - background-size: 41.5% -} - -.home-link { - display: block; - background: url(../img/home-o.svg) no-repeat 50%; - height: 1.25rem; - width: 1.25rem; - margin: .625rem -} - -.home-link.is-current, -.home-link:hover { - background-image: url(../img/home.svg) -} - -.edit-this-page { - display: none; - padding-right: .5rem -} - -@media screen and (min-width:1024px) { - .edit-this-page { - display: block - } -} - -.toolbar .edit-this-page a { - color: #8e8e8e -} - -.breadcrumbs { - display: none; - -webkit-box-flex: 1; - -ms-flex: 1 1; - flex: 1 1; - padding: 0 .5rem 0 .75rem; - line-height: 1.35 -} - -@media screen and (min-width:1024px) { - .breadcrumbs { - display: block - } -} - -a+.breadcrumbs { - padding-left: .05rem -} - -.breadcrumbs ul { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -ms-flex-wrap: wrap; - flex-wrap: wrap; - margin: 0; - padding: 0; - list-style: none -} - -.breadcrumbs li { - display: inline; - margin: 0 -} - -.breadcrumbs li::after { - content: "/"; - padding: 0 .5rem -} - -.breadcrumbs li:last-of-type::after { - content: none -} - -.page-versions { - margin: 0 .2rem 0 auto; - position: relative; - line-height: 1 -} - -@media screen and (min-width:1024px) { - .page-versions { - margin-right: .7rem - } -} - -.page-versions .version-menu-toggle { - color: inherit; - background: url(../img/chevron.svg) no-repeat; - background-position: right .5rem top 50%; - background-size: auto .75em; - border: none; - outline: none; - line-height: inherit; - padding: .5rem 1.5rem .5rem .5rem; - position: relative; - z-index: 3 -} - -.page-versions .version-menu { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - min-width: 100%; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; - -webkit-box-align: end; - -ms-flex-align: end; - align-items: flex-end; - background: -webkit-gradient(linear, left top, left bottom, from(#f0f0f0), to(#f0f0f0)) no-repeat; - background: linear-gradient(180deg, #f0f0f0 0, #f0f0f0) no-repeat; - padding: 1.375rem 1.5rem .5rem .5rem; - position: absolute; - top: 0; - right: 0; - white-space: nowrap -} - -.page-versions:not(.is-active) .version-menu { - display: none -} - -.page-versions .version { - display: block; - padding-top: .5rem -} - -.page-versions .version.is-current { - display: none -} - -.page-versions .version.is-missing { - color: #8e8e8e; - font-style: italic; - text-decoration: none -} - -.toc-menu { - color: #5d5d5d -} - -.toc.sidebar .toc-menu { - margin-right: .75rem; - position: sticky; - top: 6rem -} - -.toc .toc-menu h3 { - color: #333; - font-size: .88889rem; - font-weight: 500; - line-height: 1.3; - margin: 0 -.5px; - padding-bottom: .25rem -} - -.toc.sidebar .toc-menu h3 { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; - height: 2.5rem; - -webkit-box-pack: end; - -ms-flex-pack: end; - justify-content: flex-end -} - -.toc .toc-menu ul { - font-size: .83333rem; - line-height: 1.2; - list-style: none; - margin: 0; - padding: 0 -} - -.toc.sidebar .toc-menu ul { - max-height: calc(100vh - 8.5rem); - overflow-y: auto; - -ms-scroll-chaining: none; - overscroll-behavior: none -} - -@supports (scrollbar-width:none) { - .toc.sidebar .toc-menu ul { - scrollbar-width: none - } -} - -.toc .toc-menu ul::-webkit-scrollbar { - width: 0; - height: 0 -} - -@media screen and (min-width:1024px) { - .toc .toc-menu h3 { - font-size: .83333rem - } - - .toc .toc-menu ul { - font-size: .75rem - } -} - -.toc .toc-menu li { - margin: 0 -} - -.toc .toc-menu li[data-level="2"] a { - padding-left: 1.25rem -} - -.toc .toc-menu li[data-level="3"] a { - padding-left: 2rem -} - -.toc .toc-menu a { - color: inherit; - border-left: 2px solid #e1e1e1; - display: inline-block; - padding: .25rem 0 .25rem .5rem; - text-decoration: none -} - -.sidebar.toc .toc-menu a { - display: block; - outline: none -} - -.toc .toc-menu a:hover { - color: #1565c0 -} - -.toc .toc-menu a.is-active { - border-left-color: #1565c0; - color: #333 -} - -.sidebar.toc .toc-menu a:focus { - background: #fafafa -} - -.toc .toc-menu .is-hidden-toc { - display: none !important -} - -.doc { - color: #333; - font-size: inherit; - -webkit-hyphens: auto; - -ms-hyphens: auto; - hyphens: auto; - line-height: 1.6; - margin: 0 auto; - max-width: 40rem; - padding: 0 1rem 4rem -} - -@media screen and (min-width:1024px) { - .doc { - -webkit-box-flex: 1; - -ms-flex: auto; - flex: auto; - font-size: .94444rem; - margin: 0 2rem; - max-width: 46rem; - min-width: 0 - } -} - -.doc h1, -.doc h2, -.doc h3, -.doc h4, -.doc h5, -.doc h6 { - color: #191919; - font-weight: 400; - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none; - line-height: 1.3; - margin: 1rem 0 0 -} - -.doc>h1.page:first-child { - font-size: 2rem; - margin: 1.5rem 0 -} - -@media screen and (min-width:769px) { - .doc>h1.page:first-child { - margin-top: 2.5rem - } -} - -.doc>h1.page:first-child+aside.toc.embedded { - margin-top: -.5rem -} - -.doc>h2#name+.sectionbody { - margin-top: 1rem -} - -#preamble+.sect1, -.doc .sect1+.sect1 { - margin-top: 2rem -} - -.doc h1.sect0 { - background: #f0f0f0; - font-size: 1.8em; - margin: 1.5rem -1rem 0; - padding: .5rem 1rem -} - -.doc h2:not(.discrete) { - border-bottom: 1px solid #e1e1e1; - margin-left: -1rem; - margin-right: -1rem; - padding: .4rem 1rem .1rem -} - -.doc h3:not(.discrete), -.doc h4:not(.discrete) { - font-weight: 500 -} - -.doc h1 .anchor, -.doc h2 .anchor, -.doc h3 .anchor, -.doc h4 .anchor, -.doc h5 .anchor, -.doc h6 .anchor { - position: absolute; - text-decoration: none; - width: 1.75ex; - margin-left: -1.5ex; - visibility: hidden; - font-size: .8em; - font-weight: 400; - padding-top: .05em -} - -.doc h1 .anchor::before, -.doc h2 .anchor::before, -.doc h3 .anchor::before, -.doc h4 .anchor::before, -.doc h5 .anchor::before, -.doc h6 .anchor::before { - content: "\00a7" -} - -.doc h1:hover .anchor, -.doc h2:hover .anchor, -.doc h3:hover .anchor, -.doc h4:hover .anchor, -.doc h5:hover .anchor, -.doc h6:hover .anchor { - visibility: visible -} - -.doc dl, -.doc p { - margin: 0 -} - -.doc a { - color: #1565c0 -} - -.doc a:hover { - color: #104d92 -} - -.doc a.bare { - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none -} - -.doc a.unresolved { - color: #d32f2f -} - -.doc i.fa { - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none; - font-style: normal -} - -.doc .colist>table code, -.doc p code, -.doc thead code { - color: #222; - background: #fafafa; - border-radius: .25em; - font-size: .95em; - padding: .125em .25em -} - -.doc code, -.doc pre { - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none -} - -.doc pre { - font-size: .88889rem; - line-height: 1.5; - margin: 0 -} - -.doc blockquote { - margin: 0 -} - -.doc .paragraph.lead>p { - font-size: 1rem -} - -.doc .right { - float: right -} - -.doc .left { - float: left -} - -.doc .float-gap.right { - margin: 0 1rem 1rem 0 -} - -.doc .float-gap.left { - margin: 0 0 1rem 1rem -} - -.doc .float-group::after { - content: ""; - display: table; - clear: both -} - -.doc .stretch { - width: 100% -} - -.doc .underline { - text-decoration: underline -} - -.doc .line-through { - text-decoration: line-through -} - -.doc .dlist, -.doc .exampleblock, -.doc .hdlist, -.doc .imageblock, -.doc .listingblock, -.doc .literalblock, -.doc .olist, -.doc .paragraph, -.doc .partintro, -.doc .quoteblock, -.doc .sidebarblock, -.doc .tabs, -.doc .ulist, -.doc .verseblock, -.doc .videoblock, -.doc details, -.doc hr { - margin: 1rem 0 0 -} - -.doc table.tableblock { - font-size: .83333rem -} - -.doc .tablecontainer, -.doc .tablecontainer+*, -.doc :not(.tablecontainer)>table.tableblock, -.doc :not(.tablecontainer)>table.tableblock+* { - margin-top: 1.5rem -} - -.doc p.tableblock+p.tableblock { - margin-top: .5rem -} - -.doc td.tableblock>.content>:first-child { - margin-top: 0 -} - -.doc table.tableblock td, -.doc table.tableblock th { - padding: .5rem -} - -.doc table.tableblock, -.doc table.tableblock>*>tr>* { - border: 0 solid #e1e1e1 -} - -.doc table.grid-all>*>tr>* { - border-width: 1px -} - -.doc table.grid-cols>*>tr>* { - border-width: 0 1px -} - -.doc table.grid-rows>*>tr>* { - border-width: 1px 0 -} - -.doc table.grid-all>thead th, -.doc table.grid-rows>thead th { - border-bottom-width: 2.5px -} - -.doc table.frame-all { - border-width: 1px -} - -.doc table.frame-ends { - border-width: 1px 0 -} - -.doc table.frame-sides { - border-width: 0 1px -} - -.doc table.frame-none>colgroup+*>:first-child>*, -.doc table.frame-sides>colgroup+*>:first-child>* { - border-top-width: 0 -} - -.doc table.frame-sides>:last-child>:last-child>* { - border-bottom-width: 0 -} - -.doc table.frame-ends>*>tr>:first-child, -.doc table.frame-none>*>tr>:first-child { - border-left-width: 0 -} - -.doc table.frame-ends>*>tr>:last-child, -.doc table.frame-none>*>tr>:last-child { - border-right-width: 0 -} - -.doc table.stripes-all>tbody>tr, -.doc table.stripes-even>tbody>tr:nth-of-type(2n), -.doc table.stripes-hover>tbody>tr:hover, -.doc table.stripes-odd>tbody>tr:nth-of-type(odd) { - background: #fafafa -} - -.doc table.tableblock>tfoot { - background: -webkit-gradient(linear, left top, left bottom, from(#f0f0f0), to(#fff)); - background: linear-gradient(180deg, #f0f0f0 0, #fff) -} - -.doc .halign-left { - text-align: left -} - -.doc .halign-right { - text-align: right -} - -.doc .halign-center { - text-align: center -} - -.doc .valign-top { - vertical-align: top -} - -.doc .valign-bottom { - vertical-align: bottom -} - -.doc .valign-middle { - vertical-align: middle -} - -.doc .admonitionblock { - margin: 1.4rem 0 0 -} - -.doc .admonitionblock p, -.doc .admonitionblock td.content { - font-size: .88889rem -} - -.doc .admonitionblock td.content>.title+*, -.doc .admonitionblock td.content>:not(.title):first-child { - margin-top: 0 -} - -.doc .admonitionblock pre { - font-size: .83333rem -} - -.doc .admonitionblock>table { - table-layout: fixed; - position: relative; - width: 100% -} - -.doc .admonitionblock td.content { - padding: 1rem 1rem .75rem; - background: #fafafa; - width: 100%; - word-wrap: anywhere -} - -.doc .admonitionblock .icon { - position: absolute; - top: 0; - left: 0; - font-size: .83333rem; - padding: 0 .5rem; - height: 1.25rem; - line-height: 1; - font-weight: 500; - text-transform: uppercase; - border-radius: .45rem; - -webkit-transform: translate(-.5rem, -50%); - transform: translate(-.5rem, -50%) -} - -.doc .admonitionblock.caution .icon { - background-color: #a0439c; - color: #fff -} - -.doc .admonitionblock.important .icon { - background-color: #d32f2f; - color: #fff -} - -.doc .admonitionblock.note .icon { - background-color: #217ee7; - color: #fff -} - -.doc .admonitionblock.tip .icon { - background-color: #41af46; - color: #fff -} - -.doc .admonitionblock.warning .icon { - background-color: #e18114; - color: #fff -} - -.doc .admonitionblock .icon i { - display: -webkit-inline-box; - display: -ms-inline-flexbox; - display: inline-flex; - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; - height: 100% -} - -.doc .admonitionblock .icon i::after { - content: attr(title) -} - -.doc .imageblock, -.doc .videoblock { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center -} - -.doc .imageblock.text-left, -.doc .videoblock.text-left { - -webkit-box-align: start; - -ms-flex-align: start; - align-items: flex-start -} - -.doc .imageblock.text-right, -.doc .videoblock.text-right { - -webkit-box-align: end; - -ms-flex-align: end; - align-items: flex-end -} - -.doc .image>img, -.doc .image>object, -.doc .image>svg, -.doc .imageblock img, -.doc .imageblock object, -.doc .imageblock svg { - display: inline-block; - height: auto; - max-width: 100%; - vertical-align: middle -} - -.doc .image:not(.left):not(.right)>img { - margin-top: -.2em -} - -.doc .videoblock iframe { - max-width: 100%; - vertical-align: middle -} - -#preamble .abstract blockquote { - background: #f0f0f0; - border-left: 5px solid #e1e1e1; - color: #4a4a4a; - font-size: .88889rem; - padding: .75em 1em -} - -.doc .quoteblock, -.doc .verseblock { - background: #fafafa; - border-left: 5px solid #5d5d5d; - color: #5d5d5d -} - -.doc .quoteblock { - padding: .25rem 2rem 1.25rem -} - -.doc .quoteblock .attribution { - color: #8e8e8e; - font-size: .83333rem; - margin-top: .75rem -} - -.doc .quoteblock blockquote { - margin-top: 1rem -} - -.doc .quoteblock .paragraph { - font-style: italic -} - -.doc .quoteblock cite { - padding-left: 1em -} - -.doc .verseblock { - font-size: 1.15em; - padding: 1rem 2rem -} - -.doc .verseblock pre { - font-family: inherit; - font-size: inherit -} - -.doc ol, -.doc ul { - margin: 0; - padding: 0 0 0 2rem -} - -.doc ol.none, -.doc ol.unnumbered, -.doc ol.unstyled, -.doc ul.checklist, -.doc ul.no-bullet, -.doc ul.none, -.doc ul.unstyled { - list-style-type: none -} - -.doc ol.unnumbered, -.doc ul.no-bullet { - padding-left: 1.25rem -} - -.doc ol.unstyled, -.doc ul.unstyled { - padding-left: 0 -} - -.doc ul.circle { - list-style-type: circle -} - -.doc ul.disc { - list-style-type: disc -} - -.doc ul.square { - list-style-type: square -} - -.doc ul.circle ul:not([class]), -.doc ul.disc ul:not([class]), -.doc ul.square ul:not([class]) { - list-style: inherit -} - -.doc ol.arabic { - list-style-type: decimal -} - -.doc ol.decimal { - list-style-type: decimal-leading-zero -} - -.doc ol.loweralpha { - list-style-type: lower-alpha -} - -.doc ol.upperalpha { - list-style-type: upper-alpha -} - -.doc ol.lowerroman { - list-style-type: lower-roman -} - -.doc ol.upperroman { - list-style-type: upper-roman -} - -.doc ol.lowergreek { - list-style-type: lower-greek -} - -.doc ul.checklist { - padding-left: 1.75rem -} - -.doc ul.checklist p>i.fa-check-square-o:first-child, -.doc ul.checklist p>i.fa-square-o:first-child { - display: -webkit-inline-box; - display: -ms-inline-flexbox; - display: inline-flex; - -webkit-box-pack: center; - -ms-flex-pack: center; - justify-content: center; - width: 1.25rem; - margin-left: -1.25rem -} - -.doc ul.checklist i.fa-check-square-o::before { - content: "\2713" -} - -.doc ul.checklist i.fa-square-o::before { - content: "\274f" -} - -.doc .dlist .dlist, -.doc .dlist .olist, -.doc .dlist .ulist, -.doc .olist .dlist, -.doc .olist .olist, -.doc .olist .ulist, -.doc .olist li+li, -.doc .ulist .dlist, -.doc .ulist .olist, -.doc .ulist .ulist, -.doc .ulist li+li { - margin-top: .5rem -} - -.doc .admonitionblock .listingblock, -.doc .olist .listingblock, -.doc .ulist .listingblock { - padding: 0 -} - -.doc .admonitionblock .title, -.doc .exampleblock .title, -.doc .imageblock .title, -.doc .listingblock .title, -.doc .literalblock .title, -.doc .openblock .title, -.doc .tableblock caption, -.doc .videoblock .title { - color: #5d5d5d; - font-size: .88889rem; - font-style: italic; - font-weight: 500; - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none; - letter-spacing: .01em; - padding-bottom: .075rem -} - -.doc .tableblock caption { - text-align: left -} - -.doc .olist .title, -.doc .ulist .title { - font-style: italic; - font-weight: 500; - margin-bottom: .25rem -} - -.doc .imageblock .title { - margin-top: .5rem; - padding-bottom: 0 -} - -.doc details { - margin-left: 1rem -} - -.doc details>summary { - display: block; - position: relative; - line-height: 1.6; - margin-bottom: .5rem -} - -.doc details>summary::-webkit-details-marker { - display: none -} - -.doc details>summary::before { - content: ""; - border: solid transparent; - border-left: solid; - border-width: .3em 0 .3em .5em; - position: absolute; - top: .5em; - left: -1rem; - -webkit-transform: translateX(15%); - transform: translateX(15%) -} - -.doc details[open]>summary::before { - border-color: currentColor transparent transparent; - border-width: .5rem .3rem 0; - -webkit-transform: translateY(15%); - transform: translateY(15%) -} - -.doc details>summary::after { - content: ""; - width: 1rem; - height: 1em; - position: absolute; - top: .3em; - left: -1rem -} - -.doc details.result { - margin-top: .25rem -} - -.doc details.result>summary { - color: #5d5d5d; - font-style: italic; - margin-bottom: 0 -} - -.doc details.result>.content { - margin-left: -1rem -} - -.doc .exampleblock>.content, -.doc details.result>.content { - background: #fff; - border: .25rem solid #5d5d5d; - border-radius: .5rem; - padding: .75rem -} - -.doc .exampleblock>.content::after, -.doc details.result>.content::after { - content: ""; - display: table; - clear: both -} - -.doc .exampleblock>.content>:first-child, -.doc details>.content>:first-child { - margin-top: 0 -} - -.doc .sidebarblock { - background: #e1e1e1; - border-radius: .75rem; - padding: .75rem 1.5rem -} - -.doc .sidebarblock>.content>.title { - font-size: 1.25rem; - font-weight: 500; - line-height: 1.3; - margin-bottom: -.3em; - text-align: center -} - -.doc .sidebarblock>.content>:not(.title):first-child { - margin-top: 0 -} - -.doc .listingblock.wrap pre, -.doc .tableblock pre { - white-space: pre-wrap -} - -.doc .listingblock pre:not(.highlight), -.doc .literalblock pre, -.doc pre.highlight code { - background: #fafafa; - -webkit-box-shadow: inset 0 0 1.75px #e1e1e1; - box-shadow: inset 0 0 1.75px #e1e1e1; - display: block; - overflow-x: auto; - padding: .875em -} - -.doc .listingblock>.content { - position: relative -} - -.doc .source-toolbox { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - visibility: hidden; - position: absolute; - top: .25rem; - right: .5rem; - color: grey; - font-family: Roboto, sans-serif; - font-size: .72222rem; - line-height: 1; - white-space: nowrap; - z-index: 1 -} - -.doc .listingblock:hover .source-toolbox { - visibility: visible -} - -.doc .source-toolbox .source-lang { - text-transform: uppercase; - letter-spacing: .075em -} - -.doc .source-toolbox>:not(:last-child)::after { - content: "|"; - letter-spacing: 0; - padding: 0 1ch -} - -.doc .source-toolbox .copy-button { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; - background: none; - border: none; - color: inherit; - outline: none; - padding: 0; - font-size: inherit; - line-height: inherit; - width: 1em; - height: 1em -} - -.doc .source-toolbox .copy-icon { - -webkit-box-flex: 0; - -ms-flex: none; - flex: none; - width: inherit; - height: inherit -} - -.doc .source-toolbox img.copy-icon { - -webkit-filter: invert(50.2%); - filter: invert(50.2%) -} - -.doc .source-toolbox svg.copy-icon { - fill: currentColor -} - -.doc .source-toolbox .copy-toast { - -webkit-box-flex: 0; - -ms-flex: none; - flex: none; - position: relative; - display: -webkit-inline-box; - display: -ms-inline-flexbox; - display: inline-flex; - -webkit-box-pack: center; - -ms-flex-pack: center; - justify-content: center; - margin-top: 1em; - background-color: #333; - border-radius: .25em; - padding: .5em; - color: #fff; - cursor: auto; - opacity: 0; - -webkit-transition: opacity .5s ease .5s; - transition: opacity .5s ease .5s -} - -.doc .source-toolbox .copy-toast::after { - content: ""; - position: absolute; - top: 0; - width: 1em; - height: 1em; - border: .55em solid transparent; - border-left-color: #333; - -webkit-transform: rotate(-90deg) translateX(50%) translateY(50%); - transform: rotate(-90deg) translateX(50%) translateY(50%); - -webkit-transform-origin: left; - transform-origin: left -} - -.doc .source-toolbox .copy-button.clicked .copy-toast { - opacity: 1; - -webkit-transition: none; - transition: none -} - -.doc .language-console .hljs-meta { - -webkit-user-select: none; - -moz-user-select: none; - -ms-user-select: none; - user-select: none -} - -.doc .dlist dt { - font-style: italic -} - -.doc .dlist dd { - margin: 0 0 .25rem 1.5rem -} - -.doc .dlist dd:last-of-type { - margin-bottom: 0 -} - -.doc td.hdlist1, -.doc td.hdlist2 { - padding: .5rem 0 0; - vertical-align: top -} - -.doc tr:first-child>.hdlist1, -.doc tr:first-child>.hdlist2 { - padding-top: 0 -} - -.doc td.hdlist1 { - font-weight: 500; - padding-right: .25rem -} - -.doc td.hdlist2 { - padding-left: .25rem -} - -.doc .colist { - font-size: .88889rem; - margin: .25rem 0 -.25rem -} - -.doc .colist>table>tbody>tr>:first-child, -.doc .colist>table>tr>:first-child { - padding: .25em .5rem 0; - vertical-align: top -} - -.doc .colist>table>tbody>tr>:last-child, -.doc .colist>table>tr>:last-child { - padding: .25rem 0 -} - -.doc .conum[data-value] { - border: 1px solid; - border-radius: 100%; - display: inline-block; - font-family: Roboto, sans-serif; - font-size: .75rem; - font-style: normal; - line-height: 1.2; - text-align: center; - width: 1.25em; - height: 1.25em; - letter-spacing: -.25ex; - text-indent: -.25ex -} - -.doc .conum[data-value]::after { - content: attr(data-value) -} - -.doc .conum[data-value]+b { - display: none -} - -.doc hr { - border: solid #e1e1e1; - border-width: 2px 0 0; - height: 0 -} - -.doc b.button { - white-space: nowrap -} - -.doc b.button::before { - content: "["; - padding-right: .25em -} - -.doc b.button::after { - content: "]"; - padding-left: .25em -} - -.doc kbd { - display: inline-block; - font-size: .66667rem; - background: #fafafa; - border: 1px solid #c1c1c1; - border-radius: .25em; - -webkit-box-shadow: 0 1px 0 #c1c1c1, 0 0 0 .1em #fff inset; - box-shadow: 0 1px 0 #c1c1c1, inset 0 0 0 .1em #fff; - padding: .25em .5em; - vertical-align: text-bottom; - white-space: nowrap -} - -.doc .keyseq, -.doc kbd { - line-height: 1 -} - -.doc .keyseq { - font-size: .88889rem -} - -.doc .keyseq kbd { - margin: 0 .125em -} - -.doc .keyseq kbd:first-child { - margin-left: 0 -} - -.doc .keyseq kbd:last-child { - margin-right: 0 -} - -.doc .menuseq, -.doc .path { - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none -} - -.doc .menuseq i.caret::before { - content: "\203a"; - font-size: 1.1em; - font-weight: 500; - line-height: .90909 -} - -.doc :not(pre).nowrap { - white-space: nowrap -} - -.doc .nobreak { - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none; - word-wrap: normal -} - -#footnotes { - font-size: .85em; - line-height: 1.5; - margin: 2rem -.5rem 0 -} - -.doc td.tableblock>.content #footnotes { - margin: 2rem 0 0 -} - -#footnotes hr { - border-top-width: 1px; - margin-top: 0; - width: 20% -} - -#footnotes .footnote { - margin: .5em 0 0 1em -} - -#footnotes .footnote+.footnote { - margin-top: .25em -} - -#footnotes .footnote>a:first-of-type { - display: inline-block; - margin-left: -2em; - text-align: right; - width: 1.5em -} - -nav.pagination { - border-top: 1px solid #e1e1e1; - line-height: 1; - margin: 2rem -1rem -1rem; - padding: .75rem 1rem 0 -} - -nav.pagination, -nav.pagination span { - display: -webkit-box; - display: -ms-flexbox; - display: flex -} - -nav.pagination span { - -webkit-box-flex: 50%; - -ms-flex: 50%; - flex: 50%; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column -} - -nav.pagination .prev { - padding-right: .5rem -} - -nav.pagination .next { - margin-left: auto; - padding-left: .5rem; - text-align: right -} - -nav.pagination span::before { - color: #8e8e8e; - font-size: .75em; - padding-bottom: .1em -} - -nav.pagination .prev::before { - content: "Prev" -} - -nav.pagination .next::before { - content: "Next" -} - -nav.pagination a { - font-weight: 500; - line-height: 1.3; - position: relative -} - -nav.pagination a::after, -nav.pagination a::before { - color: #8e8e8e; - font-weight: 400; - font-size: 1.5em; - line-height: .75; - position: absolute; - top: 0; - width: 1rem -} - -nav.pagination .prev a::before { - content: "\2039"; - -webkit-transform: translateX(-100%); - transform: translateX(-100%) -} - -nav.pagination .next a::after { - content: "\203a" -} - -html.is-clipped--navbar { - overflow-y: hidden -} - -body { - padding-top: 3.5rem -} - -.navbar { - background: #191919; - color: #fff; - font-size: .88889rem; - height: 3.5rem; - position: fixed; - top: 0; - width: 100%; - z-index: 4 -} - -.navbar a { - text-decoration: none -} - -.navbar-brand { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-flex: 1; - -ms-flex: auto; - flex: auto; - padding-left: 1rem -} - -.navbar-brand .navbar-item { - color: #fff -} - -.navbar-brand .navbar-item:first-child { - -ms-flex-item-align: center; - align-self: center; - padding: 0; - font-size: 1.22222rem; - -ms-flex-wrap: wrap; - flex-wrap: wrap; - line-height: 1 -} - -.navbar-brand .navbar-item:first-child a { - color: inherit; - word-wrap: normal -} - -.navbar-brand .navbar-item:first-child :not(:last-child) { - padding-right: .375rem -} - -.navbar-brand .navbar-item.search { - -webkit-box-flex: 1; - -ms-flex: auto; - flex: auto; - -webkit-box-pack: end; - -ms-flex-pack: end; - justify-content: flex-end -} - -#search-input { - color: #333; - font-family: inherit; - font-size: .95rem; - width: 150px; - border: 1px solid #dbdbdb; - border-radius: .1em; - line-height: 1.5; - padding: 0 .25em -} - -#search-input:disabled { - background-color: #dbdbdb; - cursor: not-allowed; - pointer-events: all !important -} - -#search-input:disabled::-webkit-input-placeholder { - color: #4c4c4c -} - -#search-input:disabled::-moz-placeholder { - color: #4c4c4c -} - -#search-input:disabled:-ms-input-placeholder { - color: #4c4c4c -} - -#search-input:disabled::-ms-input-placeholder { - color: #4c4c4c -} - -#search-input:disabled::placeholder { - color: #4c4c4c -} - -#search-input:focus { - outline: none -} - -.navbar-burger { - background: none; - border: none; - outline: none; - line-height: 1; - position: relative; - width: 3rem; - padding: 0; - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-orient: vertical; - -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; - -webkit-box-pack: center; - -ms-flex-pack: center; - justify-content: center; - margin-left: auto; - min-width: 0 -} - -.navbar-burger span { - background-color: #fff; - height: 1.5px; - width: 1rem -} - -.navbar-burger:not(.is-active) span { - -webkit-transition: opacity 0s .25s, margin-top .25s ease-out .25s, -webkit-transform .25s ease-out; - transition: opacity 0s .25s, margin-top .25s ease-out .25s, -webkit-transform .25s ease-out; - transition: transform .25s ease-out, opacity 0s .25s, margin-top .25s ease-out .25s; - transition: transform .25s ease-out, opacity 0s .25s, margin-top .25s ease-out .25s, -webkit-transform .25s ease-out -} - -.navbar-burger span+span { - margin-top: .25rem -} - -.navbar-burger.is-active span+span { - margin-top: -1.5px -} - -.navbar-burger.is-active span:first-child { - -webkit-transform: rotate(45deg); - transform: rotate(45deg) -} - -.navbar-burger.is-active span:nth-child(2) { - opacity: 0 -} - -.navbar-burger.is-active span:nth-child(3) { - -webkit-transform: rotate(-45deg); - transform: rotate(-45deg) -} - -.navbar-item, -.navbar-link { - color: #222; - display: block; - line-height: 1.6; - padding: .5rem 1rem -} - -.navbar-item.has-dropdown { - padding: 0 -} - -.navbar-item .icon { - width: 1.25rem; - height: 1.25rem; - display: block -} - -.navbar-item .icon img, -.navbar-item .icon svg { - fill: currentColor; - width: inherit; - height: inherit -} - -.navbar-link { - padding-right: 2.5em -} - -.navbar-dropdown .navbar-item { - padding-left: 1.5rem; - padding-right: 1.5rem -} - -.navbar-dropdown .navbar-item.has-label { - display: -webkit-box; - display: -ms-flexbox; - display: flex; - -webkit-box-pack: justify; - -ms-flex-pack: justify; - justify-content: space-between -} - -.navbar-dropdown .navbar-item small { - color: #8e8e8e; - font-size: .66667rem -} - -.navbar-divider { - background-color: #e1e1e1; - border: none; - height: 1px; - margin: .25rem 0 -} - -.navbar .button { - display: -webkit-inline-box; - display: -ms-inline-flexbox; - display: inline-flex; - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; - background: #fff; - border: 1px solid #e1e1e1; - border-radius: .15rem; - height: 1.75rem; - color: #222; - padding: 0 .75em; - white-space: nowrap -} - -@media screen and (max-width:768.5px) { - .navbar-brand .navbar-item.search { - padding-left: 0; - padding-right: 0 - } -} - -@media screen and (min-width:769px) { - #search-input { - width: 200px - } -} - -@media screen and (max-width:1023.5px) { - .navbar-brand { - height: inherit - } - - .navbar-brand .navbar-item { - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; - display: -webkit-box; - display: -ms-flexbox; - display: flex - } - - .navbar-menu { - background: #fff; - -webkit-box-shadow: 0 8px 16px rgba(10, 10, 10, .1); - box-shadow: 0 8px 16px rgba(10, 10, 10, .1); - max-height: calc(100vh - 3.5rem); - overflow-y: auto; - -ms-scroll-chaining: none; - overscroll-behavior: none; - padding: .5rem 0 - } - - .navbar-menu:not(.is-active) { - display: none - } - - .navbar-menu .navbar-link:hover, - .navbar-menu a.navbar-item:hover { - background: #f5f5f5 - } -} - -@media screen and (min-width:1024px) { - .navbar-burger { - display: none - } - - .navbar, - .navbar-end, - .navbar-item, - .navbar-link, - .navbar-menu { - display: -webkit-box; - display: -ms-flexbox; - display: flex - } - - .navbar-item, - .navbar-link { - position: relative; - -webkit-box-flex: 0; - -ms-flex: none; - flex: none - } - - .navbar-item:not(.has-dropdown), - .navbar-link { - -webkit-box-align: center; - -ms-flex-align: center; - align-items: center - } - - .navbar-item.is-hoverable:hover .navbar-dropdown { - display: block - } - - .navbar-link::after { - border-width: 0 0 1px 1px; - border-style: solid; - content: ""; - display: block; - height: .5em; - pointer-events: none; - position: absolute; - -webkit-transform: rotate(-45deg); - transform: rotate(-45deg); - width: .5em; - margin-top: -.375em; - right: 1.125em; - top: 50% - } - - .navbar-end .navbar-link, - .navbar-end>.navbar-item { - color: #fff - } - - .navbar-end .navbar-item.has-dropdown:hover .navbar-link, - .navbar-end .navbar-link:hover, - .navbar-end>a.navbar-item:hover { - background: #000; - color: #fff - } - - .navbar-end .navbar-link::after { - border-color: currentColor - } - - .navbar-dropdown { - background: #fff; - border: 1px solid #e1e1e1; - border-top: none; - border-radius: 0 0 .25rem .25rem; - display: none; - top: 100%; - left: 0; - min-width: 100%; - position: absolute - } - - .navbar-dropdown .navbar-item { - padding: .5rem 3rem .5rem 1rem; - white-space: nowrap - } - - .navbar-dropdown .navbar-item small { - position: relative; - right: -2rem - } - - .navbar-dropdown .navbar-item:last-child { - border-radius: inherit - } - - .navbar-dropdown.is-right { - left: auto; - right: 0 - } - - .navbar-dropdown a.navbar-item:hover { - background: #f5f5f5 - } -} - -footer.footer { - background-color: #e1e1e1; - color: #5d5d5d; - font-size: .83333rem; - line-height: 1.6; - padding: 1.5rem -} - -.footer p { - margin: .5rem 0 -} - -.footer a { - color: #191919 -} - -/*! Adapted from the GitHub style by Vasily Polovnyov */ -.hljs-comment, -.hljs-quote { - color: #998; - font-style: italic -} - -.hljs-keyword, -.hljs-selector-tag, -.hljs-subst { - color: #333; - font-weight: 500 -} - -.hljs-literal, -.hljs-number, -.hljs-tag .hljs-attr, -.hljs-template-variable, -.hljs-variable { - color: teal -} - -.hljs-doctag, -.hljs-string { - color: #d14 -} - -.hljs-section, -.hljs-selector-id, -.hljs-title { - color: #900; - font-weight: 500 -} - -.hljs-subst { - font-weight: 400 -} - -.hljs-class .hljs-title, -.hljs-type { - color: #458; - font-weight: 500 -} - -.hljs-attribute, -.hljs-name, -.hljs-tag { - color: navy; - font-weight: 400 -} - -.hljs-link, -.hljs-regexp { - color: #009926 -} - -.hljs-bullet, -.hljs-symbol { - color: #990073 -} - -.hljs-built_in, -.hljs-builtin-name { - color: #0086b3 -} - -.hljs-meta { - color: #999; - font-weight: 500 -} - -.hljs-deletion { - background: #fdd -} - -.hljs-addition { - background: #dfd -} - -.hljs-emphasis { - font-style: italic -} - -.hljs-strong { - font-weight: 500 -} - -@page { - margin: .5in -} - -@media print { - .hide-for-print { - display: none !important - } - - html { - font-size: .9375em - } - - a { - color: inherit !important; - text-decoration: underline - } - - a.bare, - a[href^="#"], - a[href^="mailto:"] { - text-decoration: none - } - - img, - object, - svg, - tr { - page-break-inside: avoid - } - - thead { - display: table-header-group - } - - pre { - -webkit-hyphens: none; - -ms-hyphens: none; - hyphens: none; - white-space: pre-wrap - } - - body { - padding-top: 2rem - } - - .navbar { - background: none; - color: inherit; - position: absolute - } - - .navbar * { - color: inherit !important - } - - .nav-container, - .navbar>:not(.navbar-brand), - .toolbar, - aside.toc, - nav.pagination { - display: none - } - - .doc { - color: inherit; - margin: auto; - max-width: none; - padding-bottom: 2rem - } - - .doc .admonitionblock td.icon { - -webkit-print-color-adjust: exact; - color-adjust: exact - } - - .doc .listingblock code[data-lang]::before { - display: block - } - - footer.footer { - background: none; - border-top: 1px solid #e1e1e1; - color: #8e8e8e; - padding: .25rem .5rem 0 - } - - .footer * { - color: inherit - } -} \ No newline at end of file diff --git a/pr-preview/pr-13/_/font/roboto-latin-400-italic.woff b/pr-preview/pr-13/_/font/roboto-latin-400-italic.woff deleted file mode 100644 index ebee16b..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-400-italic.woff and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-latin-400-italic.woff2 b/pr-preview/pr-13/_/font/roboto-latin-400-italic.woff2 deleted file mode 100644 index e1b7a79..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-400-italic.woff2 and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-latin-400-normal.woff b/pr-preview/pr-13/_/font/roboto-latin-400-normal.woff deleted file mode 100644 index 9eaa94f..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-400-normal.woff and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-latin-400-normal.woff2 b/pr-preview/pr-13/_/font/roboto-latin-400-normal.woff2 deleted file mode 100644 index 020729e..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-400-normal.woff2 and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-latin-500-italic.woff b/pr-preview/pr-13/_/font/roboto-latin-500-italic.woff deleted file mode 100644 index b6ad1c5..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-500-italic.woff and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-latin-500-italic.woff2 b/pr-preview/pr-13/_/font/roboto-latin-500-italic.woff2 deleted file mode 100644 index ae1933f..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-500-italic.woff2 and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-latin-500-normal.woff b/pr-preview/pr-13/_/font/roboto-latin-500-normal.woff deleted file mode 100644 index d39bb52..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-500-normal.woff and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-latin-500-normal.woff2 b/pr-preview/pr-13/_/font/roboto-latin-500-normal.woff2 deleted file mode 100644 index 29342a8..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-latin-500-normal.woff2 and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-mono-latin-400-normal.woff b/pr-preview/pr-13/_/font/roboto-mono-latin-400-normal.woff deleted file mode 100644 index be3eb4c..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-mono-latin-400-normal.woff and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-mono-latin-400-normal.woff2 b/pr-preview/pr-13/_/font/roboto-mono-latin-400-normal.woff2 deleted file mode 100644 index f8894ba..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-mono-latin-400-normal.woff2 and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-mono-latin-500-normal.woff b/pr-preview/pr-13/_/font/roboto-mono-latin-500-normal.woff deleted file mode 100644 index 43ca6a1..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-mono-latin-500-normal.woff and /dev/null differ diff --git a/pr-preview/pr-13/_/font/roboto-mono-latin-500-normal.woff2 b/pr-preview/pr-13/_/font/roboto-mono-latin-500-normal.woff2 deleted file mode 100644 index b4f2bf8..0000000 Binary files a/pr-preview/pr-13/_/font/roboto-mono-latin-500-normal.woff2 and /dev/null differ diff --git a/pr-preview/pr-13/_/img/back.svg b/pr-preview/pr-13/_/img/back.svg deleted file mode 100644 index bf7d30e..0000000 --- a/pr-preview/pr-13/_/img/back.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/pr-preview/pr-13/_/img/caret.svg b/pr-preview/pr-13/_/img/caret.svg deleted file mode 100644 index 1af41bc..0000000 --- a/pr-preview/pr-13/_/img/caret.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/pr-preview/pr-13/_/img/chevron.svg b/pr-preview/pr-13/_/img/chevron.svg deleted file mode 100644 index 40e962a..0000000 --- a/pr-preview/pr-13/_/img/chevron.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/pr-preview/pr-13/_/img/hat-logo.png b/pr-preview/pr-13/_/img/hat-logo.png deleted file mode 100644 index 47128f4..0000000 Binary files a/pr-preview/pr-13/_/img/hat-logo.png and /dev/null differ diff --git a/pr-preview/pr-13/_/img/home-o.svg b/pr-preview/pr-13/_/img/home-o.svg deleted file mode 100644 index 95d193b..0000000 --- a/pr-preview/pr-13/_/img/home-o.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/pr-preview/pr-13/_/img/home.svg b/pr-preview/pr-13/_/img/home.svg deleted file mode 100644 index 4e96b35..0000000 --- a/pr-preview/pr-13/_/img/home.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/pr-preview/pr-13/_/img/menu.svg b/pr-preview/pr-13/_/img/menu.svg deleted file mode 100644 index 8b43b2e..0000000 --- a/pr-preview/pr-13/_/img/menu.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/pr-preview/pr-13/_/img/octicons-16.svg b/pr-preview/pr-13/_/img/octicons-16.svg deleted file mode 100644 index e3b4e20..0000000 --- a/pr-preview/pr-13/_/img/octicons-16.svg +++ /dev/null @@ -1 +0,0 @@ -Octicons v11.2.0 by GitHub - https://primer.style/octicons/ - License: MIT \ No newline at end of file diff --git a/pr-preview/pr-13/_/img/redhat-logo.png b/pr-preview/pr-13/_/img/redhat-logo.png deleted file mode 100644 index a9cf250..0000000 Binary files a/pr-preview/pr-13/_/img/redhat-logo.png and /dev/null differ diff --git a/pr-preview/pr-13/_/img/rhl-logo-red.png b/pr-preview/pr-13/_/img/rhl-logo-red.png deleted file mode 100644 index 954ab68..0000000 Binary files a/pr-preview/pr-13/_/img/rhl-logo-red.png and /dev/null differ diff --git a/pr-preview/pr-13/_/js/site.js b/pr-preview/pr-13/_/js/site.js deleted file mode 100644 index 74a8b5f..0000000 --- a/pr-preview/pr-13/_/js/site.js +++ /dev/null @@ -1,6 +0,0 @@ -!function(){"use strict";var e,o,r,s=/^sect(\d)$/,i=document.querySelector(".nav-container"),a=document.querySelector(".nav-toggle"),c=i.querySelector(".nav"),l=(a.addEventListener("click",function(e){if(a.classList.contains("is-active"))return u(e);v(e);var e=document.documentElement,t=(e.classList.add("is-clipped--nav"),a.classList.add("is-active"),i.classList.add("is-active"),c.getBoundingClientRect()),n=window.innerHeight-Math.round(t.top);Math.round(t.height)!==n&&(c.style.height=n+"px");e.addEventListener("click",u)}),i.addEventListener("click",v),i.querySelector("[data-panel=menu]"));function t(){var e,t,n=window.location.hash;if(n&&(n.indexOf("%")&&(n=decodeURIComponent(n)),!(e=l.querySelector('.nav-link[href="'+n+'"]')))){n=document.getElementById(n.slice(1));if(n)for(var i=n,a=document.querySelector("article.doc");(i=i.parentNode)&&i!==a;){var c=i.id;if((c=c||(c=s.test(i.className))&&(i.firstElementChild||{}).id)&&(e=l.querySelector('.nav-link[href="#'+c+'"]')))break}}if(e)t=e.parentNode;else{if(!r)return;e=(t=r).querySelector(".nav-link")}t!==o&&(h(l,".nav-item.is-active").forEach(function(e){e.classList.remove("is-active","is-current-path","is-current-page")}),t.classList.add("is-current-page"),d(o=t),p(l,e))}function d(e){for(var t,n=e.parentNode;!(t=n.classList).contains("nav-menu");)"LI"===n.tagName&&t.contains("nav-item")&&t.add("is-active","is-current-path"),n=n.parentNode;e.classList.add("is-active")}function n(){var e,t,n,i;this.classList.toggle("is-active")&&(e=parseFloat(window.getComputedStyle(this).marginTop),t=this.getBoundingClientRect(),n=l.getBoundingClientRect(),0<(i=(t.bottom-n.top-n.height+e).toFixed()))&&(l.scrollTop+=Math.min((t.top-n.top-e).toFixed(),i))}function u(e){v(e);e=document.documentElement;e.classList.remove("is-clipped--nav"),a.classList.remove("is-active"),i.classList.remove("is-active"),e.removeEventListener("click",u)}function v(e){e.stopPropagation()}function p(e,t){var n=e.getBoundingClientRect(),i=n.height,a=window.getComputedStyle(c);"sticky"===a.position&&(i-=n.top-parseFloat(a.top)),e.scrollTop=Math.max(0,.5*(t.getBoundingClientRect().height-i)+t.offsetTop)}function h(e,t){return[].slice.call(e.querySelectorAll(t))}l&&(e=i.querySelector("[data-panel=explore]"),o=l.querySelector(".is-current-page"),(r=o)?(d(o),p(l,o.querySelector(".nav-link"))):l.scrollTop=0,h(l,".nav-item-toggle").forEach(function(e){var t=e.parentElement,e=(e.addEventListener("click",n.bind(t)),function(e,t){e=e.nextElementSibling;return(!e||!t||e[e.matches?"matches":"msMatchesSelector"](t))&&e}(e,".nav-text"));e&&(e.style.cursor="pointer",e.addEventListener("click",n.bind(t)))}),e&&e.querySelector(".context").addEventListener("click",function(){h(c,"[data-panel]").forEach(function(e){e.classList.toggle("is-active")})}),l.addEventListener("mousedown",function(e){1":"")+".sect"+c);r.push("h"+(i+1)+"[id]")}else r.push("h1[id].sect0");n.push(r.join(">"))}m=n.join(","),f=d.parentNode;var a,s=[].slice.call((f||document).querySelectorAll(m));if(!s.length)return e.parentNode.removeChild(e);var l={},u=s.reduce(function(e,t){var o=document.createElement("a"),n=(o.textContent=t.textContent,l[o.href="#"+t.id]=o,document.createElement("li"));return n.dataset.level=parseInt(t.nodeName.slice(1),10)-1,n.appendChild(o),e.appendChild(n),e},document.createElement("ul")),f=e.querySelector(".toc-menu"),m=(f||((f=document.createElement("div")).className="toc-menu"),document.createElement("h3")),e=(m.textContent=e.dataset.title||"Contents",f.appendChild(m),f.appendChild(u),!document.getElementById("toc")&&d.querySelector("h1.page ~ :not(.is-before-toc)"));e&&((m=document.createElement("aside")).className="toc embedded",m.appendChild(f.cloneNode(!0)),e.parentNode.insertBefore(m,e)),window.addEventListener("load",function(){p(),window.addEventListener("scroll",p)})}}function p(){var n,i,t,e=window.pageYOffset,o=1.15*h(document.documentElement,"fontSize"),r=d.offsetTop;e&&window.innerHeight+e+2>=document.documentElement.scrollHeight?(a=Array.isArray(a)?a:Array(a||0),n=[],i=s.length-1,s.forEach(function(e,t){var o="#"+e.id;t===i||e.getBoundingClientRect().top+h(e,"paddingTop")>r?(n.push(o),a.indexOf(o)<0&&l[o].classList.add("is-active")):~a.indexOf(o)&&l[a.shift()].classList.remove("is-active")}),u.scrollTop=u.scrollHeight-u.offsetHeight,a=1r)return!0;t="#"+e.id}),t?t!==a&&(a&&l[a].classList.remove("is-active"),(e=l[t]).classList.add("is-active"),u.scrollHeight>u.offsetHeight&&(u.scrollTop=Math.max(0,e.offsetTop+e.offsetHeight-u.offsetHeight)),a=t):a&&(l[a].classList.remove("is-active"),a=void 0))}function h(e,t){return parseFloat(window.getComputedStyle(e)[t])}}(); -!function(){"use strict";var o=document.querySelector("article.doc"),t=document.querySelector(".toolbar");function i(e){return e&&(~e.indexOf("%")?decodeURIComponent(e):e).slice(1)}function r(e){if(e){if(e.altKey||e.ctrlKey)return;window.location.hash="#"+this.id,e.preventDefault()}window.scrollTo(0,function e(t,n){return o.contains(t)?e(t.offsetParent,t.offsetTop+n):n}(this,0)-t.getBoundingClientRect().bottom)}window.addEventListener("load",function e(t){var n;(n=i(window.location.hash))&&(n=document.getElementById(n))&&(r.bind(n)(),setTimeout(r.bind(n),0)),window.removeEventListener("load",e)}),Array.prototype.slice.call(document.querySelectorAll('a[href^="#"]')).forEach(function(e){var t;(t=i(e.hash))&&(t=document.getElementById(t))&&e.addEventListener("click",r.bind(t))})}(); -!function(){"use strict";var t,e=document.querySelector(".page-versions .version-menu-toggle");e&&(t=document.querySelector(".page-versions"),e.addEventListener("click",function(e){t.classList.toggle("is-active"),e.stopPropagation()}),document.documentElement.addEventListener("click",function(){t.classList.remove("is-active")}))}(); -!function(){"use strict";var t=document.querySelector(".navbar-burger");t&&t.addEventListener("click",function(t){t.stopPropagation(),document.documentElement.classList.toggle("is-clipped--navbar"),this.classList.toggle("is-active");t=document.getElementById(this.dataset.target);{var e;t.classList.toggle("is-active")&&(t.style.maxHeight="",e=window.innerHeight-Math.round(t.getBoundingClientRect().top),parseInt(window.getComputedStyle(t).maxHeight,10)!==e)&&(t.style.maxHeight=e+"px")}}.bind(t))}(); -!function(){"use strict";var o=/^\$ (\S[^\\\n]*(\\\n(?!\$ )[^\\\n]*)*)(?=\n|$)/gm,s=/( ) *\\\n *|\\\n( ?) */g,l=/ +$/gm,e=(document.getElementById("site-script")||{dataset:{}}).dataset,d=null==e.uiRootPath?".":e.uiRootPath,r=e.svgAs,p=window.navigator.clipboard;[].slice.call(document.querySelectorAll(".doc pre.highlight, .doc .literalblock pre")).forEach(function(e){var t,n,a,c;if(e.classList.contains("highlight"))(i=(t=e.querySelector("code")).dataset.lang)&&"console"!==i&&((a=document.createElement("span")).className="source-lang",a.appendChild(document.createTextNode(i)));else{if(!e.innerText.startsWith("$ "))return;var i=e.parentNode.parentNode;i.classList.remove("literalblock"),i.classList.add("listingblock"),e.classList.add("highlightjs","highlight"),(t=document.createElement("code")).className="language-console hljs",t.dataset.lang="console",t.appendChild(e.firstChild),e.appendChild(t)}(i=document.createElement("div")).className="source-toolbox",a&&i.appendChild(a),p&&((n=document.createElement("button")).className="copy-button",n.setAttribute("title","Copy to clipboard"),"svg"===r?((a=document.createElementNS("http://www.w3.org/2000/svg","svg")).setAttribute("class","copy-icon"),(c=document.createElementNS("http://www.w3.org/2000/svg","use")).setAttribute("href",d+"/img/octicons-16.svg#icon-clippy"),a.appendChild(c),n.appendChild(a)):((c=document.createElement("img")).src=d+"/img/octicons-16.svg#view-clippy",c.alt="copy icon",c.className="copy-icon",n.appendChild(c)),(a=document.createElement("span")).className="copy-toast",a.appendChild(document.createTextNode("Copied!")),n.appendChild(a),i.appendChild(n)),e.parentNode.appendChild(i),n&&n.addEventListener("click",function(e){var t=e.innerText.replace(l,"");"console"===e.dataset.lang&&t.startsWith("$ ")&&(t=function(e){var t,n=[];for(;t=o.exec(e);)n.push(t[1].replace(s,"$1$2"));return n.join(" && ")}(t));window.navigator.clipboard.writeText(t).then(function(){this.classList.add("clicked"),this.offsetHeight,this.classList.remove("clicked")}.bind(this),function(){})}.bind(n,t))})}(); \ No newline at end of file diff --git a/pr-preview/pr-13/_/js/vendor/highlight.js b/pr-preview/pr-13/_/js/vendor/highlight.js deleted file mode 100644 index f0be714..0000000 --- a/pr-preview/pr-13/_/js/vendor/highlight.js +++ /dev/null @@ -1 +0,0 @@ -!function(){function e(e){return{aliases:["adoc"],contains:[e.COMMENT("^/{4,}\\n","\\n/{4,}$",{relevance:10}),e.COMMENT("^//","$",{relevance:0}),{className:"title",begin:"^\\.\\w.*$"},{begin:"^[=\\*]{4,}\\n",end:"\\n^[=\\*]{4,}$",relevance:10},{className:"section",relevance:10,variants:[{begin:"^(={1,5}) .+?( \\1)?$"},{begin:"^[^\\[\\]\\n]+?\\n[=\\-~\\^\\+]{2,}$"}]},{className:"meta",begin:"^:.+?:",end:"\\s",excludeEnd:!0,relevance:10},{className:"meta",begin:"^\\[.+?\\]$",relevance:0},{className:"quote",begin:"^_{4,}\\n",end:"\\n_{4,}$",relevance:10},{className:"code",begin:"^[\\-\\.]{4,}\\n",end:"\\n[\\-\\.]{4,}$",relevance:10},{begin:"^\\+{4,}\\n",end:"\\n\\+{4,}$",contains:[{begin:"<",end:">",subLanguage:"xml",relevance:0}],relevance:10},{className:"bullet",begin:"^(\\*+|\\-+|\\.+|[^\\n]+?::)\\s+"},{className:"symbol",begin:"^(NOTE|TIP|IMPORTANT|WARNING|CAUTION):\\s+",relevance:10},{className:"strong",begin:"\\B\\*(?![\\*\\s])",end:"(\\n{2}|\\*)",contains:[{begin:"\\\\*\\w",relevance:0}]},{className:"emphasis",begin:"\\B'(?!['\\s])",end:"(\\n{2}|')",contains:[{begin:"\\\\'\\w",relevance:0}],relevance:0},{className:"emphasis",begin:"_(?![_\\s])",end:"(\\n{2}|_)",relevance:0},{className:"string",variants:[{begin:"``.+?''"},{begin:"`.+?'"}]},{className:"code",begin:"(`.+?`|\\+.+?\\+)",relevance:0},{className:"code",begin:"^[ \\t]",end:"$",relevance:0},{begin:"^'{3,}[ \\t]*$",relevance:10},{begin:"(link:)?(http|https|ftp|file|irc|image:?):\\S+\\[.*?\\]",returnBegin:!0,contains:[{begin:"(link|image:?):",relevance:0},{className:"link",begin:"\\w",end:"[^\\[]+",relevance:0},{className:"string",begin:"\\[",end:"\\]",excludeBegin:!0,excludeEnd:!0,relevance:0}],relevance:10}]}}function n(e){var n={className:"variable",variants:[{begin:/\$[\w\d#@][\w\d_]*/},{begin:/\$\{(.*?)}/}]},a={className:"string",begin:/"/,end:/"/,contains:[e.BACKSLASH_ESCAPE,n,{className:"variable",begin:/\$\(/,end:/\)/,contains:[e.BACKSLASH_ESCAPE]}]};return{aliases:["sh","zsh"],lexemes:/\b-?[a-z\._]+\b/,keywords:{keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",_:"-ne -eq -lt -gt -f -d -e -s -l -a"},contains:[{className:"meta",begin:/^#![^\n]+sh\s*$/,relevance:10},{className:"function",begin:/\w[\w\d_]*\s*\(\s*\)\s*\{/,returnBegin:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/\w[\w\d_]*/})],relevance:0},e.HASH_COMMENT_MODE,a,{className:"",begin:/\\"/},{className:"string",begin:/'/,end:/'/},n]}}function a(e){var n={begin:u="["+(u="a-zA-Z_\\-!.?+*=<>&#'")+"]["+u+"0-9/;:]*",relevance:0},a={className:"number",begin:"[-+]?\\d+(\\.\\d+)?",relevance:0},t=e.inherit(e.QUOTE_STRING_MODE,{illegal:null}),i=e.COMMENT(";","$",{relevance:0}),s={className:"literal",begin:/\b(true|false|nil)\b/},r={begin:"[\\[\\{]",end:"[\\]\\}]"},l={className:"comment",begin:"\\^"+u},o=e.COMMENT("\\^\\{","\\}"),c={className:"symbol",begin:"[:]{1,2}"+u},d={begin:"\\(",end:"\\)"},g={endsWithParent:!0,relevance:0},u={keywords:{"builtin-name":"def defonce cond apply if-not if-let if not not= = < > <= >= == + / * - rem quot neg? pos? delay? symbol? keyword? true? false? integer? empty? coll? list? set? ifn? fn? associative? sequential? sorted? counted? reversible? number? decimal? class? distinct? isa? float? rational? reduced? ratio? odd? even? char? seq? vector? string? map? nil? contains? zero? instance? not-every? not-any? libspec? -> ->> .. . inc compare do dotimes mapcat take remove take-while drop letfn drop-last take-last drop-while while intern condp case reduced cycle split-at split-with repeat replicate iterate range merge zipmap declare line-seq sort comparator sort-by dorun doall nthnext nthrest partition eval doseq await await-for let agent atom send send-off release-pending-sends add-watch mapv filterv remove-watch agent-error restart-agent set-error-handler error-handler set-error-mode! error-mode shutdown-agents quote var fn loop recur throw try monitor-enter monitor-exit defmacro defn defn- macroexpand macroexpand-1 for dosync and or when when-not when-let comp juxt partial sequence memoize constantly complement identity assert peek pop doto proxy defstruct first rest cons defprotocol cast coll deftype defrecord last butlast sigs reify second ffirst fnext nfirst nnext defmulti defmethod meta with-meta ns in-ns create-ns import refer keys select-keys vals key val rseq name namespace promise into transient persistent! conj! assoc! dissoc! pop! disj! use class type num float double short byte boolean bigint biginteger bigdec print-method print-dup throw-if printf format load compile get-in update-in pr pr-on newline flush read slurp read-line subvec with-open memfn time re-find re-groups rand-int rand mod locking assert-valid-fdecl alias resolve ref deref refset swap! reset! set-validator! compare-and-set! alter-meta! reset-meta! commute get-validator alter ref-set ref-history-count ref-min-history ref-max-history ensure sync io! new next conj set! to-array future future-call into-array aset gen-class reduce map filter find empty hash-map hash-set sorted-map sorted-map-by sorted-set sorted-set-by vec vector seq flatten reverse assoc dissoc list disj get union difference intersection extend extend-type extend-protocol int nth delay count concat chunk chunk-buffer chunk-append chunk-first chunk-rest max min dec unchecked-inc-int unchecked-inc unchecked-dec-inc unchecked-dec unchecked-negate unchecked-add-int unchecked-add unchecked-subtract-int unchecked-subtract chunk-next chunk-cons chunked-seq? prn vary-meta lazy-seq spread list* str find-keyword keyword symbol gensym force rationalize"},lexemes:u,className:"name",begin:u,starts:g},n=[d,t,l,o,i,c,r,a,s,n];return d.contains=[e.COMMENT("comment",""),u,g],g.contains=n,r.contains=n,o.contains=[r],{aliases:["clj"],illegal:/\S/,contains:[d,t,l,o,i,c,r,a,s]}}function t(e){function n(e){return"(?:"+e+")?"}var a="decltype\\(auto\\)",t="[a-zA-Z_]\\w*::",i={className:"keyword",begin:"\\b[a-z\\d_]*_t\\b"},s={className:"string",variants:[{begin:'(u8?|U|L)?"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{begin:"(u8?|U|L)?'(\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)|.)",end:"'",illegal:"."},{begin:/(?:u8?|U|L)?R"([^()\\ ]{0,16})\((?:.|\n)*?\)\1"/}]},r={className:"number",variants:[{begin:"\\b(0b[01']+)"},{begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],relevance:0},l={className:"meta",begin:/#\s*[a-z]+\b/,end:/$/,keywords:{"meta-keyword":"if else elif endif define undef warning error line pragma _Pragma ifdef ifndef include"},contains:[{begin:/\\\n/,relevance:0},e.inherit(s,{className:"meta-string"}),{className:"meta-string",begin:/<.*?>/,end:/$/,illegal:"\\n"},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},o={className:"title",begin:n(t)+e.IDENT_RE,relevance:0},t=n(t)+e.IDENT_RE+"\\s*\\(",c={keyword:"int float while private char char8_t char16_t char32_t catch import module export virtual operator sizeof dynamic_cast|10 typedef const_cast|10 const for static_cast|10 union namespace unsigned long volatile static protected bool template mutable if public friend do goto auto void enum else break extern using asm case typeid wchar_tshort reinterpret_cast|10 default double register explicit signed typename try this switch continue inline delete alignas alignof constexpr consteval constinit decltype concept co_await co_return co_yield requires noexcept static_assert thread_local restrict final override atomic_bool atomic_char atomic_schar atomic_uchar atomic_short atomic_ushort atomic_int atomic_uint atomic_long atomic_ulong atomic_llong atomic_ullong new throw return and and_eq bitand bitor compl not not_eq or or_eq xor xor_eq",built_in:"std string wstring cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap array shared_ptr abort terminate abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf future isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf endl initializer_list unique_ptr _Bool complex _Complex imaginary _Imaginary",literal:"true false nullptr NULL"},d=[i,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,r,s],g={variants:[{begin:/=/,end:/;/},{begin:/\(/,end:/\)/},{beginKeywords:"new throw return else",end:/;/}],keywords:c,contains:d.concat([{begin:/\(/,end:/\)/,keywords:c,contains:d.concat(["self"]),relevance:0}]),relevance:0},a={className:"function",begin:"((decltype\\(auto\\)|(?:[a-zA-Z_]\\w*::)?[a-zA-Z_]\\w*(?:<.*?>)?)[\\*&\\s]+)+"+t,returnBegin:!0,end:/[{;=]/,excludeEnd:!0,keywords:c,illegal:/[^\w\s\*&:<>]/,contains:[{begin:a,keywords:c,relevance:0},{begin:t,returnBegin:!0,contains:[o],relevance:0},{className:"params",begin:/\(/,end:/\)/,keywords:c,relevance:0,contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,s,r,i,{begin:/\(/,end:/\)/,keywords:c,relevance:0,contains:["self",e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,s,r,i]}]},i,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,l]};return{aliases:["c","cc","h","c++","h++","hpp","hh","hxx","cxx"],keywords:c,illegal:"",keywords:c,contains:["self",i]},{begin:e.IDENT_RE+"::",keywords:c},{className:"class",beginKeywords:"class struct",end:/[{;:]/,contains:[{begin://,contains:["self"]},e.TITLE_MODE]}]),exports:{preprocessor:l,strings:s,keywords:c}}}function i(e){var n={keyword:"abstract as base bool break byte case catch char checked const continue decimal default delegate do double enum event explicit extern finally fixed float for foreach goto if implicit in int interface internal is lock long object operator out override params private protected public readonly ref sbyte sealed short sizeof stackalloc static string struct switch this try typeof uint ulong unchecked unsafe ushort using virtual void volatile while add alias ascending async await by descending dynamic equals from get global group into join let nameof on orderby partial remove select set value var when where yield",literal:"null false true"},a={className:"number",variants:[{begin:"\\b(0b[01']+)"},{begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],relevance:0},t={className:"string",begin:'@"',end:'"',contains:[{begin:'""'}]},i=e.inherit(t,{illegal:/\n/}),s={className:"subst",begin:"{",end:"}",keywords:n},r=e.inherit(s,{illegal:/\n/}),l={className:"string",begin:/\$"/,end:'"',illegal:/\n/,contains:[{begin:"{{"},{begin:"}}"},e.BACKSLASH_ESCAPE,r]},o={className:"string",begin:/\$@"/,end:'"',contains:[{begin:"{{"},{begin:"}}"},{begin:'""'},s]},c=e.inherit(o,{illegal:/\n/,contains:[{begin:"{{"},{begin:"}}"},{begin:'""'},r]}),s=(s.contains=[o,l,t,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.C_BLOCK_COMMENT_MODE],r.contains=[c,l,i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.inherit(e.C_BLOCK_COMMENT_MODE,{illegal:/\n/})],{variants:[o,l,t,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]}),r=e.IDENT_RE+"(<"+e.IDENT_RE+"(\\s*,\\s*"+e.IDENT_RE+")*>)?(\\[\\])?";return{aliases:["csharp","c#"],keywords:n,illegal:/::/,contains:[e.COMMENT("///","$",{returnBegin:!0,contains:[{className:"doctag",variants:[{begin:"///",relevance:0},{begin:"\x3c!--|--\x3e"},{begin:""}]}]}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"meta",begin:"#",end:"$",keywords:{"meta-keyword":"if else elif endif define undef warning error line region endregion pragma checksum"}},s,a,{beginKeywords:"class interface",end:/[{;=]/,illegal:/[^\s:,]/,contains:[e.TITLE_MODE,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{beginKeywords:"namespace",end:/[{;=]/,illegal:/[^\s:]/,contains:[e.inherit(e.TITLE_MODE,{begin:"[a-zA-Z](\\.?\\w)*"}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"meta",begin:"^\\s*\\[",excludeBegin:!0,end:"\\]",excludeEnd:!0,contains:[{className:"meta-string",begin:/"/,end:/"/}]},{beginKeywords:"new return throw await else",relevance:0},{className:"function",begin:"("+r+"\\s+)+"+e.IDENT_RE+"\\s*\\(",returnBegin:!0,end:/\s*[{;=]/,excludeEnd:!0,keywords:n,contains:[{begin:e.IDENT_RE+"\\s*\\(",returnBegin:!0,contains:[e.TITLE_MODE],relevance:0},{className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:n,relevance:0,contains:[s,a,e.C_BLOCK_COMMENT_MODE]},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]}]}}function s(e){var n={className:"attribute",begin:/\S/,end:":",excludeEnd:!0,starts:{endsWithParent:!0,excludeEnd:!0,contains:[{begin:/[\w-]+\(/,returnBegin:!0,contains:[{className:"built_in",begin:/[\w-]+/},{begin:/\(/,end:/\)/,contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.CSS_NUMBER_MODE]}]},e.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,e.C_BLOCK_COMMENT_MODE,{className:"number",begin:"#[0-9A-Fa-f]+"},{className:"meta",begin:"!important"}]}};return{case_insensitive:!0,illegal:/[=\/|'\$]/,contains:[e.C_BLOCK_COMMENT_MODE,{className:"selector-id",begin:/#[A-Za-z0-9_-]+/},{className:"selector-class",begin:/\.[A-Za-z0-9_-]+/},{className:"selector-attr",begin:/\[/,end:/\]/,illegal:"$",contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},{className:"selector-pseudo",begin:/:(:)?[a-zA-Z0-9\_\-\+\(\)"'.]+/},{begin:"@(page|font-face)",lexemes:"@[a-z-]+",keywords:"@page @font-face"},{begin:"@",end:"[{;]",illegal:/:/,returnBegin:!0,contains:[{className:"keyword",begin:/@\-?\w[\w]*(\-\w+)*/},{begin:/\s/,endsWithParent:!0,excludeEnd:!0,relevance:0,keywords:"and or not only",contains:[{begin:/[a-z-]+:/,className:"attribute"},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.CSS_NUMBER_MODE]}]},{className:"selector-tag",begin:"[a-zA-Z-][a-zA-Z0-9_-]*",relevance:0},{begin:"{",end:"}",illegal:/\S/,contains:[e.C_BLOCK_COMMENT_MODE,{begin:/(?:[A-Z\_\.\-]+|--[a-zA-Z0-9_-]+)\s*:/,returnBegin:!0,end:";",endsWithParent:!0,contains:[n]}]}]}}function r(e){return{aliases:["patch"],contains:[{className:"meta",relevance:10,variants:[{begin:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{begin:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{begin:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{className:"comment",variants:[{begin:/Index: /,end:/$/},{begin:/={3,}/,end:/$/},{begin:/^\-{3}/,end:/$/},{begin:/^\*{3} /,end:/$/},{begin:/^\+{3}/,end:/$/},{begin:/^\*{15}$/}]},{className:"addition",begin:"^\\+",end:"$"},{className:"deletion",begin:"^\\-",end:"$"},{className:"addition",begin:"^\\!",end:"$"}]}}function l(e){return{aliases:["docker"],case_insensitive:!0,keywords:"from maintainer expose env arg user onbuild stopsignal",contains:[e.HASH_COMMENT_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.NUMBER_MODE,{beginKeywords:"run cmd entrypoint volume add copy workdir label healthcheck shell",starts:{end:/[^\\]$/,subLanguage:"bash"}}],illegal:"/}]}]}]},s={className:"string",begin:"~[A-Z](?="+s+")",contains:[{begin:/"/,end:/"/},{begin:/'/,end:/'/},{begin:/\//,end:/\//},{begin:/\|/,end:/\|/},{begin:/\(/,end:/\)/},{begin:/\[/,end:/\]/},{begin:/\{/,end:/\}/},{begin:/\/}]},r={className:"string",contains:[e.BACKSLASH_ESCAPE,t],variants:[{begin:/"""/,end:/"""/},{begin:/'''/,end:/'''/},{begin:/~S"""/,end:/"""/,contains:[]},{begin:/~S"/,end:/"/,contains:[]},{begin:/~S'''/,end:/'''/,contains:[]},{begin:/~S'/,end:/'/,contains:[]},{begin:/'/,end:/'/},{begin:/"/,end:/"/}]},l={className:"function",beginKeywords:"def defp defmacro",end:/\B\b/,contains:[e.inherit(e.TITLE_MODE,{begin:n,endsParent:!0})]},o=e.inherit(l,{className:"class",beginKeywords:"defimpl defmodule defprotocol defrecord",end:/\bdo\b|$|;/}),s=[r,s,i,e.HASH_COMMENT_MODE,o,l,{begin:"::"},{className:"symbol",begin:":(?![\\s:])",contains:[r,{begin:"[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?"}],relevance:0},{className:"symbol",begin:n+":(?!:)",relevance:0},{className:"number",begin:"(\\b0o[0-7_]+)|(\\b0b[01_]+)|(\\b0x[0-9a-fA-F_]+)|(-?\\b[1-9][0-9_]*(.[0-9_]+([eE][-+]?[0-9]+)?)?)",relevance:0},{className:"variable",begin:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{begin:"->"},{begin:"("+e.RE_STARTERS_RE+")\\s*",contains:[e.HASH_COMMENT_MODE,{className:"regexp",illegal:"\\n",contains:[e.BACKSLASH_ESCAPE,t],variants:[{begin:"/",end:"/[a-z]*"},{begin:"%r\\[",end:"\\][a-z]*"}]}],relevance:0}];return{lexemes:n,keywords:a,contains:t.contains=s}}function c(e){var n={keyword:"break default func interface select case map struct chan else goto package switch const fallthrough if range type continue for import return var go defer bool byte complex64 complex128 float32 float64 int8 int16 int32 int64 string uint8 uint16 uint32 uint64 int uint uintptr rune",literal:"true false iota nil",built_in:"append cap close complex copy imag len make new panic print println real recover delete"};return{aliases:["golang"],keywords:n,illegal:"|<-"}]}}function u(e){var n="false synchronized int abstract float private char boolean var static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private module requires exports do",a={className:"number",begin:"\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",relevance:0};return{aliases:["jsp"],keywords:n,illegal:/<\/|#/,contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{begin:/\w+@/,relevance:0},{className:"doctag",begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"class",beginKeywords:"class interface",end:/[{;=]/,excludeEnd:!0,keywords:"class interface",illegal:/[:"\[\]]/,contains:[{beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"new throw return else",relevance:0},{className:"function",begin:"([À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*(<[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*(\\s*,\\s*[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*)*>)?\\s+)+"+e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,end:/[{;=]/,excludeEnd:!0,keywords:n,contains:[{begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0,contains:[e.UNDERSCORE_TITLE_MODE]},{className:"params",begin:/\(/,end:/\)/,keywords:n,relevance:0,contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE]},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},a,{className:"meta",begin:"@[A-Za-z]+"}]}}function _(e){var n="<>",a="",t=/<[A-Za-z0-9\\._:-]+/,i=/\/[A-Za-z0-9\\._:-]+>|\/>/,s="[A-Za-z$_][0-9A-Za-z$_]*",r={keyword:"in of if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const export super debugger as async await static import from as",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document Symbol Set Map WeakSet WeakMap Proxy Reflect Promise"},l={className:"number",variants:[{begin:"\\b(0[bB][01]+)n?"},{begin:"\\b(0[oO][0-7]+)n?"},{begin:e.C_NUMBER_RE+"n?"}],relevance:0},o={className:"subst",begin:"\\$\\{",end:"\\}",keywords:r,contains:[]},c={begin:"html`",end:"",starts:{end:"`",returnEnd:!1,contains:[e.BACKSLASH_ESCAPE,o],subLanguage:"xml"}},d={begin:"css`",end:"",starts:{end:"`",returnEnd:!1,contains:[e.BACKSLASH_ESCAPE,o],subLanguage:"css"}},g={className:"string",begin:"`",end:"`",contains:[e.BACKSLASH_ESCAPE,o]},o=(o.contains=[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,c,d,g,l,e.REGEXP_MODE],o.contains.concat([e.C_BLOCK_COMMENT_MODE,e.C_LINE_COMMENT_MODE]));return{aliases:["js","jsx","mjs","cjs"],keywords:r,contains:[{className:"meta",relevance:10,begin:/^\s*['"]use (strict|asm)['"]/},{className:"meta",begin:/^#!/,end:/$/},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,c,d,g,e.C_LINE_COMMENT_MODE,e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag",begin:"@[A-Za-z]+",contains:[{className:"type",begin:"\\{",end:"\\}",relevance:0},{className:"variable",begin:s+"(?=\\s*(-)|$)",endsParent:!0,relevance:0},{begin:/(?=[^\n])\s/,relevance:0}]}]}),e.C_BLOCK_COMMENT_MODE,l,{begin:/[{,\n]\s*/,relevance:0,contains:[{begin:s+"\\s*:",returnBegin:!0,relevance:0,contains:[{className:"attr",begin:s,relevance:0}]}]},{begin:"("+e.RE_STARTERS_RE+"|\\b(case|return|throw)\\b)\\s*",keywords:"return throw case",contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.REGEXP_MODE,{className:"function",begin:"(\\(.*?\\)|"+s+")\\s*=>",returnBegin:!0,end:"\\s*=>",contains:[{className:"params",variants:[{begin:s},{begin:/\(\s*\)/},{begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:r,contains:o}]}]},{className:"",begin:/\s/,end:/\s*/,skip:!0},{variants:[{begin:n,end:a},{begin:t,end:i}],subLanguage:"xml",contains:[{begin:t,end:i,skip:!0,contains:["self"]}]}],relevance:0},{className:"function",beginKeywords:"function",end:/\{/,excludeEnd:!0,contains:[e.inherit(e.TITLE_MODE,{begin:s}),{className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,contains:o}],illegal:/\[|%/},{begin:/\$[(.]/},e.METHOD_GUARD,{className:"class",beginKeywords:"class",end:/[{;=]/,excludeEnd:!0,illegal:/[:"\[\]]/,contains:[{beginKeywords:"extends"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"constructor get set",end:/\{/,excludeEnd:!0}],illegal:/#(?!!)/}}function m(e){var n={literal:"true false null"},a=[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE],t=[e.QUOTE_STRING_MODE,e.C_NUMBER_MODE],i={end:",",endsWithParent:!0,excludeEnd:!0,contains:t,keywords:n},s={begin:"{",end:"}",contains:[{className:"attr",begin:/"/,end:/"/,contains:[e.BACKSLASH_ESCAPE],illegal:"\\n"},e.inherit(i,{begin:/:/})].concat(a),illegal:"\\S"},e={begin:"\\[",end:"\\]",contains:[e.inherit(i)],illegal:"\\S"};return t.push(s,e),a.forEach(function(e){t.push(e)}),{contains:t,keywords:n,illegal:"\\S"}}function b(e){var n={keyword:"abstract as val var vararg get set class object open private protected public noinline crossinline dynamic final enum if else do while for when throw try catch finally import package is in fun override companion reified inline lateinit init interface annotation data sealed internal infix operator out by constructor super tailrec where const inner suspend typealias external expect actual trait volatile transient native default",built_in:"Byte Short Char Int Long Boolean Float Double Void Unit Nothing",literal:"true false null"},a={className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"@"},t={className:"subst",begin:"\\${",end:"}",contains:[e.C_NUMBER_MODE]},i={className:"string",variants:[{begin:'"""',end:'"""(?=[^"])',contains:[i={className:"variable",begin:"\\$"+e.UNDERSCORE_IDENT_RE},t]},{begin:"'",end:"'",illegal:/\n/,contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"',illegal:/\n/,contains:[e.BACKSLASH_ESCAPE,i,t]}]},t=(t.contains.push(i),{className:"meta",begin:"@(?:file|property|field|get|set|receiver|param|setparam|delegate)\\s*:(?:\\s*"+e.UNDERSCORE_IDENT_RE+")?"}),s={className:"meta",begin:"@"+e.UNDERSCORE_IDENT_RE,contains:[{begin:/\(/,end:/\)/,contains:[e.inherit(i,{className:"meta-string"})]}]},r={className:"number",begin:"\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",relevance:0},l=e.COMMENT("/\\*","\\*/",{contains:[e.C_BLOCK_COMMENT_MODE]}),o={variants:[{className:"type",begin:e.UNDERSCORE_IDENT_RE},{begin:/\(/,end:/\)/,contains:[]}]},c=o;return c.variants[1].contains=[o],o.variants[1].contains=[c],{aliases:["kt"],keywords:n,contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag",begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,l,{className:"keyword",begin:/\b(break|continue|return|this)\b/,starts:{contains:[{className:"symbol",begin:/@\w+/}]}},a,t,s,{className:"function",beginKeywords:"fun",end:"[(]|$",returnBegin:!0,excludeEnd:!0,keywords:n,illegal:/fun\s+(<.*>)?[^\s\(]+(\s+[^\s\(]+)\s*=/,relevance:5,contains:[{begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0,contains:[e.UNDERSCORE_TITLE_MODE]},{className:"type",begin://,keywords:"reified",relevance:0},{className:"params",begin:/\(/,end:/\)/,endsParent:!0,keywords:n,relevance:0,contains:[{begin:/:/,end:/[=,\/]/,endsWithParent:!0,contains:[o,e.C_LINE_COMMENT_MODE,l],relevance:0},e.C_LINE_COMMENT_MODE,l,t,s,i,e.C_NUMBER_MODE]},l]},{className:"class",beginKeywords:"class interface trait",end:/[:\{(]|$/,excludeEnd:!0,illegal:"extends implements",contains:[{beginKeywords:"public protected internal private constructor"},e.UNDERSCORE_TITLE_MODE,{className:"type",begin://,excludeBegin:!0,excludeEnd:!0,relevance:0},{className:"type",begin:/[,:]\s*/,end:/[<\(,]|$/,excludeBegin:!0,returnEnd:!0},t,s]},i,{className:"meta",begin:"^#!/usr/bin/env",end:"$",illegal:"\n"},r]}}function p(e){var n="\\[=*\\[",a="\\]=*\\]",t={begin:n,end:a,contains:["self"]},i=[e.COMMENT("--(?!"+n+")","$"),e.COMMENT("--"+n,a,{contains:[t],relevance:10})];return{lexemes:e.UNDERSCORE_IDENT_RE,keywords:{literal:"true false nil",keyword:"and break do else elseif end for goto if in local not or repeat return then until while",built_in:"_G _ENV _VERSION __index __newindex __mode __call __metatable __tostring __len __gc __add __sub __mul __div __mod __pow __concat __unm __eq __lt __le assert collectgarbage dofile error getfenv getmetatable ipairs load loadfile loadstringmodule next pairs pcall print rawequal rawget rawset require select setfenvsetmetatable tonumber tostring type unpack xpcall arg selfcoroutine resume yield status wrap create running debug getupvalue debug sethook getmetatable gethook setmetatable setlocal traceback setfenv getinfo setupvalue getlocal getregistry getfenv io lines write close flush open output type read stderr stdin input stdout popen tmpfile math log max acos huge ldexp pi cos tanh pow deg tan cosh sinh random randomseed frexp ceil floor rad abs sqrt modf asin min mod fmod log10 atan2 exp sin atan os exit setlocale date getenv difftime remove time clock tmpname rename execute package preload loadlib loaded loaders cpath config path seeall string sub upper len gfind rep find match char dump gmatch reverse byte format gsub lower table setn insert getn foreachi maxn foreach concat sort remove"},contains:i.concat([{className:"function",beginKeywords:"function",end:"\\)",contains:[e.inherit(e.TITLE_MODE,{begin:"([_a-zA-Z]\\w*\\.)*([_a-zA-Z]\\w*:)?[_a-zA-Z]\\w*"}),{className:"params",begin:"\\(",endsWithParent:!0,contains:i}].concat(i)},e.C_NUMBER_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"string",begin:n,end:a,contains:[t],relevance:5}])}}function f(e){return{aliases:["md","mkdown","mkd"],contains:[{className:"section",variants:[{begin:"^#{1,6}",end:"$"},{begin:"^.+?\\n[=-]{2,}$"}]},{begin:"<",end:">",subLanguage:"xml",relevance:0},{className:"bullet",begin:"^\\s*([*+-]|(\\d+\\.))\\s+"},{className:"strong",begin:"[*_]{2}.+?[*_]{2}"},{className:"emphasis",variants:[{begin:"\\*.+?\\*"},{begin:"_.+?_",relevance:0}]},{className:"quote",begin:"^>\\s+",end:"$"},{className:"code",variants:[{begin:"^```\\w*\\s*$",end:"^```[ ]*$"},{begin:"`.+?`"},{begin:"^( {4}|\\t)",end:"$",relevance:0}]},{begin:"^[-\\*]{3,}",end:"$"},{begin:"\\[.+?\\][\\(\\[].*?[\\)\\]]",returnBegin:!0,contains:[{className:"string",begin:"\\[",end:"\\]",excludeBegin:!0,returnEnd:!0,relevance:0},{className:"link",begin:"\\]\\(",end:"\\)",excludeBegin:!0,excludeEnd:!0},{className:"symbol",begin:"\\]\\[",end:"\\]",excludeBegin:!0,excludeEnd:!0}],relevance:10},{begin:/^\[[^\n]+\]:/,returnBegin:!0,contains:[{className:"symbol",begin:/\[/,end:/\]/,excludeBegin:!0,excludeEnd:!0},{className:"link",begin:/:\s*/,end:/$/,excludeBegin:!0}]}]}}function E(e){var n={keyword:"rec with let in inherit assert if else then",literal:"true false or and null",built_in:"import abort baseNameOf dirOf isNull builtins map removeAttrs throw toString derivation"},a={className:"subst",begin:/\$\{/,end:/}/,keywords:n},e=[e.NUMBER_MODE,e.HASH_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"string",contains:[a],variants:[{begin:"''",end:"''"},{begin:'"',end:'"'}]},{begin:/[a-zA-Z0-9-_]+(\s*=)/,returnBegin:!0,relevance:0,contains:[{className:"attr",begin:/\S+/}]}];return{aliases:["nixos"],keywords:n,contains:a.contains=e}}function N(e){return{disableAutodetect:!0}}function h(e){var n=/[a-zA-Z@][a-zA-Z0-9_]*/,a="@interface @class @protocol @implementation";return{aliases:["mm","objc","obj-c"],keywords:{keyword:"int float while char export sizeof typedef const struct for union unsigned long volatile static bool mutable if do return goto void enum else break extern asm case short default double register explicit signed typename this switch continue wchar_t inline readonly assign readwrite self @synchronized id typeof nonatomic super unichar IBOutlet IBAction strong weak copy in out inout bycopy byref oneway __strong __weak __block __autoreleasing @private @protected @public @try @property @end @throw @catch @finally @autoreleasepool @synthesize @dynamic @selector @optional @required @encode @package @import @defs @compatibility_alias __bridge __bridge_transfer __bridge_retained __bridge_retain __covariant __contravariant __kindof _Nonnull _Nullable _Null_unspecified __FUNCTION__ __PRETTY_FUNCTION__ __attribute__ getter setter retain unsafe_unretained nonnull nullable null_unspecified null_resettable class instancetype NS_DESIGNATED_INITIALIZER NS_UNAVAILABLE NS_REQUIRES_SUPER NS_RETURNS_INNER_POINTER NS_INLINE NS_AVAILABLE NS_DEPRECATED NS_ENUM NS_OPTIONS NS_SWIFT_UNAVAILABLE NS_ASSUME_NONNULL_BEGIN NS_ASSUME_NONNULL_END NS_REFINED_FOR_SWIFT NS_SWIFT_NAME NS_SWIFT_NOTHROW NS_DURING NS_HANDLER NS_ENDHANDLER NS_VALUERETURN NS_VOIDRETURN",literal:"false true FALSE TRUE nil YES NO NULL",built_in:"BOOL dispatch_once_t dispatch_queue_t dispatch_sync dispatch_async dispatch_once"},lexemes:n,illegal:"/,end:/$/,illegal:"\\n"},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"class",begin:"("+a.split(" ").join("|")+")\\b",end:"({|$)",excludeEnd:!0,keywords:a,lexemes:n,contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"\\."+e.UNDERSCORE_IDENT_RE,relevance:0}]}}function v(e){var n="getpwent getservent quotemeta msgrcv scalar kill dbmclose undef lc ma syswrite tr send umask sysopen shmwrite vec qx utime local oct semctl localtime readpipe do return format read sprintf dbmopen pop getpgrp not getpwnam rewinddir qqfileno qw endprotoent wait sethostent bless s|0 opendir continue each sleep endgrent shutdown dump chomp connect getsockname die socketpair close flock exists index shmgetsub for endpwent redo lstat msgctl setpgrp abs exit select print ref gethostbyaddr unshift fcntl syscall goto getnetbyaddr join gmtime symlink semget splice x|0 getpeername recv log setsockopt cos last reverse gethostbyname getgrnam study formline endhostent times chop length gethostent getnetent pack getprotoent getservbyname rand mkdir pos chmod y|0 substr endnetent printf next open msgsnd readdir use unlink getsockopt getpriority rindex wantarray hex system getservbyport endservent int chr untie rmdir prototype tell listen fork shmread ucfirst setprotoent else sysseek link getgrgid shmctl waitpid unpack getnetbyname reset chdir grep split require caller lcfirst until warn while values shift telldir getpwuid my getprotobynumber delete and sort uc defined srand accept package seekdir getprotobyname semop our rename seek if q|0 chroot sysread setpwent no crypt getc chown sqrt write setnetent setpriority foreach tie sin msgget map stat getlogin unless elsif truncate exec keys glob tied closedirioctl socket readlink eval xor readline binmode setservent eof ord bind alarm pipe atan2 getgrent exp time push setgrent gt lt or ne m|0 break given say state when",a={className:"subst",begin:"[$@]\\{",end:"\\}",keywords:n},t={begin:"->{",end:"}"},i={variants:[{begin:/\$\d/},{begin:/[\$%@](\^\w\b|#\w+(::\w+)*|{\w+}|\w+(::\w*)*)/},{begin:/[\$%@][^\s\w{]/,relevance:0}]},s=[e.BACKSLASH_ESCAPE,a,i],i=[i,e.HASH_COMMENT_MODE,e.COMMENT("^\\=\\w","\\=cut",{endsWithParent:!0}),t,{className:"string",contains:s,variants:[{begin:"q[qwxr]?\\s*\\(",end:"\\)",relevance:5},{begin:"q[qwxr]?\\s*\\[",end:"\\]",relevance:5},{begin:"q[qwxr]?\\s*\\{",end:"\\}",relevance:5},{begin:"q[qwxr]?\\s*\\|",end:"\\|",relevance:5},{begin:"q[qwxr]?\\s*\\<",end:"\\>",relevance:5},{begin:"qw\\s+q",end:"q",relevance:5},{begin:"'",end:"'",contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"'},{begin:"`",end:"`",contains:[e.BACKSLASH_ESCAPE]},{begin:"{\\w+}",contains:[],relevance:0},{begin:"-?\\w+\\s*\\=\\>",contains:[],relevance:0}]},{className:"number",begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",relevance:0},{begin:"(\\/\\/|"+e.RE_STARTERS_RE+"|\\b(split|return|print|reverse|grep)\\b)\\s*",keywords:"split return print reverse grep",relevance:0,contains:[e.HASH_COMMENT_MODE,{className:"regexp",begin:"(s|tr|y)/(\\\\.|[^/])*/(\\\\.|[^/])*/[a-z]*",relevance:10},{className:"regexp",begin:"(m|qr)?/",end:"/[a-z]*",contains:[e.BACKSLASH_ESCAPE],relevance:0}]},{className:"function",beginKeywords:"sub",end:"(\\s*\\(.*?\\))?[;{]",excludeEnd:!0,relevance:5,contains:[e.TITLE_MODE]},{begin:"-\\w\\b",relevance:0},{begin:"^__DATA__$",end:"^__END__$",subLanguage:"mojolicious",contains:[{begin:"^@@.*",end:"$",className:"comment"}]}];return a.contains=i,{aliases:["pl","pm"],lexemes:/[\w\.]+/,keywords:n,contains:t.contains=i}}function y(e){var n={begin:"\\$+[a-zA-Z_-ÿ][a-zA-Z0-9_-ÿ]*"},a={className:"meta",begin:/<\?(php)?|\?>/},t={className:"string",contains:[e.BACKSLASH_ESCAPE,a],variants:[{begin:'b"',end:'"'},{begin:"b'",end:"'"},e.inherit(e.APOS_STRING_MODE,{illegal:null}),e.inherit(e.QUOTE_STRING_MODE,{illegal:null})]},i={variants:[e.BINARY_NUMBER_MODE,e.C_NUMBER_MODE]};return{aliases:["php","php3","php4","php5","php6","php7"],case_insensitive:!0,keywords:"and include_once list abstract global private echo interface as static endswitch array null if endwhile or const for endforeach self var while isset public protected exit foreach throw elseif include __FILE__ empty require_once do xor return parent clone use __CLASS__ __LINE__ else break print eval new catch __METHOD__ case exception default die require __FUNCTION__ enddeclare final try switch continue endfor endif declare unset true false trait goto instanceof insteadof __DIR__ __NAMESPACE__ yield finally",contains:[e.HASH_COMMENT_MODE,e.COMMENT("//","$",{contains:[a]}),e.COMMENT("/\\*","\\*/",{contains:[{className:"doctag",begin:"@[A-Za-z]+"}]}),e.COMMENT("__halt_compiler.+?;",!1,{endsWithParent:!0,keywords:"__halt_compiler",lexemes:e.UNDERSCORE_IDENT_RE}),{className:"string",begin:/<<<['"]?\w+['"]?$/,end:/^\w+;?$/,contains:[e.BACKSLASH_ESCAPE,{className:"subst",variants:[{begin:/\$\w+/},{begin:/\{\$/,end:/\}/}]}]},a,{className:"keyword",begin:/\$this\b/},n,{begin:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{className:"function",beginKeywords:"function",end:/[;{]/,excludeEnd:!0,illegal:"\\$|\\[|%",contains:[e.UNDERSCORE_TITLE_MODE,{className:"params",begin:"\\(",end:"\\)",contains:["self",n,e.C_BLOCK_COMMENT_MODE,t,i]}]},{className:"class",beginKeywords:"class interface",end:"{",excludeEnd:!0,illegal:/[:\(\$"]/,contains:[{beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"namespace",end:";",illegal:/[\.']/,contains:[e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"use",end:";",contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"=>"},t,i]}}function w(e){var n="[ \\t\\f]*",a="("+n+"[:=]"+n+"|[ \\t\\f]+)",t="([^\\\\\\W:= \\t\\f\\n]|\\\\.)+",i="([^\\\\:= \\t\\f\\n]|\\\\.)+",s={end:a,relevance:0,starts:{className:"string",end:/$/,relevance:0,contains:[{begin:"\\\\\\n"}]}};return{case_insensitive:!0,illegal:/\S/,contains:[e.COMMENT("^\\s*[!#]","$"),{begin:t+a,returnBegin:!0,contains:[{className:"attr",begin:t,endsParent:!0,relevance:0}],starts:s},{begin:i+a,returnBegin:!0,relevance:0,contains:[{className:"meta",begin:i,endsParent:!0,relevance:0}],starts:s},{className:"attr",relevance:0,begin:i+n+"$"}]}}function O(e){var n=e.COMMENT("#","$"),a="([A-Za-z_]|::)(\\w|::)*",t=e.inherit(e.TITLE_MODE,{begin:a}),a={className:"variable",begin:"\\$"+a},i={className:"string",contains:[e.BACKSLASH_ESCAPE,a],variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/}]};return{aliases:["pp"],contains:[n,a,i,{beginKeywords:"class",end:"\\{|;",illegal:/=/,contains:[t,n]},{beginKeywords:"define",end:/\{/,contains:[{className:"section",begin:e.IDENT_RE,endsParent:!0}]},{begin:e.IDENT_RE+"\\s+\\{",returnBegin:!0,end:/\S/,contains:[{className:"keyword",begin:e.IDENT_RE},{begin:/\{/,end:/\}/,keywords:{keyword:"and case default else elsif false if in import enherits node or true undef unless main settings $string ",literal:"alias audit before loglevel noop require subscribe tag owner ensure group mode name|0 changes context force incl lens load_path onlyif provider returns root show_diff type_check en_address ip_address realname command environment hour monute month monthday special target weekday creates cwd ogoutput refresh refreshonly tries try_sleep umask backup checksum content ctime force ignore links mtime purge recurse recurselimit replace selinux_ignore_defaults selrange selrole seltype seluser source souirce_permissions sourceselect validate_cmd validate_replacement allowdupe attribute_membership auth_membership forcelocal gid ia_load_module members system host_aliases ip allowed_trunk_vlans description device_url duplex encapsulation etherchannel native_vlan speed principals allow_root auth_class auth_type authenticate_user k_of_n mechanisms rule session_owner shared options device fstype enable hasrestart directory present absent link atboot blockdevice device dump pass remounts poller_tag use message withpath adminfile allow_virtual allowcdrom category configfiles flavor install_options instance package_settings platform responsefile status uninstall_options vendor unless_system_user unless_uid binary control flags hasstatus manifest pattern restart running start stop allowdupe auths expiry gid groups home iterations key_membership keys managehome membership password password_max_age password_min_age profile_membership profiles project purge_ssh_keys role_membership roles salt shell uid baseurl cost descr enabled enablegroups exclude failovermethod gpgcheck gpgkey http_caching include includepkgs keepalive metadata_expire metalink mirrorlist priority protect proxy proxy_password proxy_username repo_gpgcheck s3_enabled skip_if_unavailable sslcacert sslclientcert sslclientkey sslverify mounted",built_in:"architecture augeasversion blockdevices boardmanufacturer boardproductname boardserialnumber cfkey dhcp_servers domain ec2_ ec2_userdata facterversion filesystems ldom fqdn gid hardwareisa hardwaremodel hostname id|0 interfaces ipaddress ipaddress_ ipaddress6 ipaddress6_ iphostnumber is_virtual kernel kernelmajversion kernelrelease kernelversion kernelrelease kernelversion lsbdistcodename lsbdistdescription lsbdistid lsbdistrelease lsbmajdistrelease lsbminordistrelease lsbrelease macaddress macaddress_ macosx_buildversion macosx_productname macosx_productversion macosx_productverson_major macosx_productversion_minor manufacturer memoryfree memorysize netmask metmask_ network_ operatingsystem operatingsystemmajrelease operatingsystemrelease osfamily partitions path physicalprocessorcount processor processorcount productname ps puppetversion rubysitedir rubyversion selinux selinux_config_mode selinux_config_policy selinux_current_mode selinux_current_mode selinux_enforced selinux_policyversion serialnumber sp_ sshdsakey sshecdsakey sshrsakey swapencrypted swapfree swapsize timezone type uniqueid uptime uptime_days uptime_hours uptime_seconds uuid virtual vlans xendomains zfs_version zonenae zones zpool_version"},relevance:0,contains:[i,n,{begin:"[a-zA-Z_]+\\s*=>",returnBegin:!0,end:"=>",contains:[{className:"attr",begin:e.IDENT_RE}]},{className:"number",begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",relevance:0},a]}],relevance:0}]}}function M(e){var n={keyword:"and elif is global as in if from raise for except finally print import pass return exec else break not with class assert yield try while continue del or def lambda async await nonlocal|10",built_in:"Ellipsis NotImplemented",literal:"False None True"},a={className:"meta",begin:/^(>>>|\.\.\.) /},t={className:"subst",begin:/\{/,end:/\}/,keywords:n,illegal:/#/},i={begin:/\{\{/,relevance:0},i={className:"string",contains:[e.BACKSLASH_ESCAPE],variants:[{begin:/(u|b)?r?'''/,end:/'''/,contains:[e.BACKSLASH_ESCAPE,a],relevance:10},{begin:/(u|b)?r?"""/,end:/"""/,contains:[e.BACKSLASH_ESCAPE,a],relevance:10},{begin:/(fr|rf|f)'''/,end:/'''/,contains:[e.BACKSLASH_ESCAPE,a,i,t]},{begin:/(fr|rf|f)"""/,end:/"""/,contains:[e.BACKSLASH_ESCAPE,a,i,t]},{begin:/(u|r|ur)'/,end:/'/,relevance:10},{begin:/(u|r|ur)"/,end:/"/,relevance:10},{begin:/(b|br)'/,end:/'/},{begin:/(b|br)"/,end:/"/},{begin:/(fr|rf|f)'/,end:/'/,contains:[e.BACKSLASH_ESCAPE,i,t]},{begin:/(fr|rf|f)"/,end:/"/,contains:[e.BACKSLASH_ESCAPE,i,t]},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},s={className:"number",relevance:0,variants:[{begin:e.BINARY_NUMBER_RE+"[lLjJ]?"},{begin:"\\b(0o[0-7]+)[lLjJ]?"},{begin:e.C_NUMBER_RE+"[lLjJ]?"}]},r={className:"params",begin:/\(/,end:/\)/,contains:["self",a,s,i,e.HASH_COMMENT_MODE]};return t.contains=[i,s,a],{aliases:["py","gyp","ipython"],keywords:n,illegal:/(<\/|->|\?)|=>/,contains:[a,s,{beginKeywords:"if",relevance:0},i,e.HASH_COMMENT_MODE,{variants:[{className:"function",beginKeywords:"def"},{className:"class",beginKeywords:"class"}],end:/:/,illegal:/[${=;\n,]/,contains:[e.UNDERSCORE_TITLE_MODE,r,{begin:/->/,endsWithParent:!0,keywords:"None"}]},{className:"meta",begin:/^[\t ]*@/,end:/$/},{begin:/\b(print|exec)\(/}]}}function x(e){var n="[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?",a={keyword:"and then defined module in return redo if BEGIN retry end for self when next until do begin unless END rescue else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor",literal:"true false nil"},t={className:"doctag",begin:"@[A-Za-z]+"},i={begin:"#<",end:">"},t=[e.COMMENT("#","$",{contains:[t]}),e.COMMENT("^\\=begin","^\\=end",{contains:[t],relevance:10}),e.COMMENT("^__END__","\\n$")],s={className:"subst",begin:"#\\{",end:"}",keywords:a},r={className:"string",contains:[e.BACKSLASH_ESCAPE,s],variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/`/,end:/`/},{begin:"%[qQwWx]?\\(",end:"\\)"},{begin:"%[qQwWx]?\\[",end:"\\]"},{begin:"%[qQwWx]?{",end:"}"},{begin:"%[qQwWx]?<",end:">"},{begin:"%[qQwWx]?/",end:"/"},{begin:"%[qQwWx]?%",end:"%"},{begin:"%[qQwWx]?-",end:"-"},{begin:"%[qQwWx]?\\|",end:"\\|"},{begin:/\B\?(\\\d{1,3}|\\x[A-Fa-f0-9]{1,2}|\\u[A-Fa-f0-9]{4}|\\?\S)\b/},{begin:/<<[-~]?'?(\w+)(?:.|\n)*?\n\s*\1\b/,returnBegin:!0,contains:[{begin:/<<[-~]?'?/},{begin:/\w+/,endSameAsBegin:!0,contains:[e.BACKSLASH_ESCAPE,s]}]}]},l={className:"params",begin:"\\(",end:"\\)",endsParent:!0,keywords:a},r=[r,i,{className:"class",beginKeywords:"class module",end:"$|;",illegal:/=/,contains:[e.inherit(e.TITLE_MODE,{begin:"[A-Za-z_]\\w*(::\\w+)*(\\?|\\!)?"}),{begin:"<\\s*",contains:[{begin:"("+e.IDENT_RE+"::)?"+e.IDENT_RE}]}].concat(t)},{className:"function",beginKeywords:"def",end:"$|;",contains:[e.inherit(e.TITLE_MODE,{begin:n}),l].concat(t)},{begin:e.IDENT_RE+"::"},{className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"(\\!|\\?)?:",relevance:0},{className:"symbol",begin:":(?!\\s)",contains:[r,{begin:n}],relevance:0},{className:"number",begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",relevance:0},{begin:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{className:"params",begin:/\|/,end:/\|/,keywords:a},{begin:"("+e.RE_STARTERS_RE+"|unless)\\s*",keywords:"unless",contains:[i,{className:"regexp",contains:[e.BACKSLASH_ESCAPE,s],illegal:/\n/,variants:[{begin:"/",end:"/[a-z]*"},{begin:"%r{",end:"}[a-z]*"},{begin:"%r\\(",end:"\\)[a-z]*"},{begin:"%r!",end:"![a-z]*"},{begin:"%r\\[",end:"\\][a-z]*"}]}].concat(t),relevance:0}].concat(t);return s.contains=r,{aliases:["rb","gemspec","podspec","thor","irb"],keywords:a,illegal:/\/\*/,contains:t.concat([{begin:/^\s*=>/,starts:{end:"$",contains:l.contains=r}},{className:"meta",begin:"^([>?]>|[\\w#]+\\(\\w+\\):\\d+:\\d+>|(\\w+-)?\\d+\\.\\d+\\.\\d(p\\d+)?[^>]+>)",starts:{end:"$",contains:r}}]).concat(r)}}function C(e){var n="([ui](8|16|32|64|128|size)|f(32|64))?",a="drop i8 i16 i32 i64 i128 isize u8 u16 u32 u64 u128 usize f32 f64 str char bool Box Option Result String Vec Copy Send Sized Sync Drop Fn FnMut FnOnce ToOwned Clone Debug PartialEq PartialOrd Eq Ord AsRef AsMut Into From Default Iterator Extend IntoIterator DoubleEndedIterator ExactSizeIterator SliceConcatExt ToString assert! assert_eq! bitflags! bytes! cfg! col! concat! concat_idents! debug_assert! debug_assert_eq! env! panic! file! format! format_args! include_bin! include_str! line! local_data_key! module_path! option_env! print! println! select! stringify! try! unimplemented! unreachable! vec! write! writeln! macro_rules! assert_ne! debug_assert_ne!";return{aliases:["rs"],keywords:{keyword:"abstract as async await become box break const continue crate do dyn else enum extern false final fn for if impl in let loop macro match mod move mut override priv pub ref return self Self static struct super trait true try type typeof unsafe unsized use virtual where while yield",literal:"true false Some None Ok Err",built_in:a},lexemes:e.IDENT_RE+"!?",illegal:""}]}}function S(e){var n={className:"subst",variants:[{begin:"\\$[A-Za-z0-9_]+"},{begin:"\\${",end:"}"}]},n={className:"string",variants:[{begin:'"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{begin:'"""',end:'"""',relevance:10},{begin:'[a-z]+"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE,n]},{className:"string",begin:'[a-z]+"""',end:'"""',contains:[n],relevance:10}]},a={className:"type",begin:"\\b[A-Z][A-Za-z0-9_]*",relevance:0},t={className:"title",begin:/[^0-9\n\t "'(),.`{}\[\]:;][^\n\t "'(),.`{}\[\]:;]+|[^0-9\n\t "'(),.`{}\[\]:;=]/,relevance:0};return{keywords:{literal:"true false null",keyword:"type yield lazy override def with val var sealed abstract private trait object if forSome for while throw finally protected extends import final return else break new catch super class case package default try this match continue throws implicit"},contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,n,{className:"symbol",begin:"'\\w[\\w\\d_]*(?!')"},a,{className:"function",beginKeywords:"def",end:/[:={\[(\n;]/,excludeEnd:!0,contains:[t]},{className:"class",beginKeywords:"class object trait type",end:/[:={\[\n;]/,excludeEnd:!0,contains:[{beginKeywords:"extends with",relevance:10},{begin:/\[/,end:/\]/,excludeBegin:!0,excludeEnd:!0,relevance:0,contains:[a]},{className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,relevance:0,contains:[a]},t]},e.C_NUMBER_MODE,{className:"meta",begin:"@[A-Za-z]+"}]}}function T(e){return{aliases:["console"],contains:[{className:"meta",begin:"^\\s{0,3}[/\\w\\d\\[\\]()@-]*[>%$#]",starts:{end:"$",subLanguage:"bash"}}]}}function k(e){var n=e.COMMENT("--","$");return{case_insensitive:!0,illegal:/[<>{}*]/,contains:[{beginKeywords:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke comment values with",end:/;/,endsWithParent:!0,lexemes:/[\w\.]+/,keywords:{keyword:"as abort abs absolute acc acce accep accept access accessed accessible account acos action activate add addtime admin administer advanced advise aes_decrypt aes_encrypt after agent aggregate ali alia alias all allocate allow alter always analyze ancillary and anti any anydata anydataset anyschema anytype apply archive archived archivelog are as asc ascii asin assembly assertion associate asynchronous at atan atn2 attr attri attrib attribu attribut attribute attributes audit authenticated authentication authid authors auto autoallocate autodblink autoextend automatic availability avg backup badfile basicfile before begin beginning benchmark between bfile bfile_base big bigfile bin binary_double binary_float binlog bit_and bit_count bit_length bit_or bit_xor bitmap blob_base block blocksize body both bound bucket buffer_cache buffer_pool build bulk by byte byteordermark bytes cache caching call calling cancel capacity cascade cascaded case cast catalog category ceil ceiling chain change changed char_base char_length character_length characters characterset charindex charset charsetform charsetid check checksum checksum_agg child choose chr chunk class cleanup clear client clob clob_base clone close cluster_id cluster_probability cluster_set clustering coalesce coercibility col collate collation collect colu colum column column_value columns columns_updated comment commit compact compatibility compiled complete composite_limit compound compress compute concat concat_ws concurrent confirm conn connec connect connect_by_iscycle connect_by_isleaf connect_by_root connect_time connection consider consistent constant constraint constraints constructor container content contents context contributors controlfile conv convert convert_tz corr corr_k corr_s corresponding corruption cos cost count count_big counted covar_pop covar_samp cpu_per_call cpu_per_session crc32 create creation critical cross cube cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime customdatum cycle data database databases datafile datafiles datalength date_add date_cache date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts day day_to_second dayname dayofmonth dayofweek dayofyear days db_role_change dbtimezone ddl deallocate declare decode decompose decrement decrypt deduplicate def defa defau defaul default defaults deferred defi defin define degrees delayed delegate delete delete_all delimited demand dense_rank depth dequeue des_decrypt des_encrypt des_key_file desc descr descri describ describe descriptor deterministic diagnostics difference dimension direct_load directory disable disable_all disallow disassociate discardfile disconnect diskgroup distinct distinctrow distribute distributed div do document domain dotnet double downgrade drop dumpfile duplicate duration each edition editionable editions element ellipsis else elsif elt empty enable enable_all enclosed encode encoding encrypt end end-exec endian enforced engine engines enqueue enterprise entityescaping eomonth error errors escaped evalname evaluate event eventdata events except exception exceptions exchange exclude excluding execu execut execute exempt exists exit exp expire explain explode export export_set extended extent external external_1 external_2 externally extract failed failed_login_attempts failover failure far fast feature_set feature_value fetch field fields file file_name_convert filesystem_like_logging final finish first first_value fixed flash_cache flashback floor flush following follows for forall force foreign form forma format found found_rows freelist freelists freepools fresh from from_base64 from_days ftp full function general generated get get_format get_lock getdate getutcdate global global_name globally go goto grant grants greatest group group_concat group_id grouping grouping_id groups gtid_subtract guarantee guard handler hash hashkeys having hea head headi headin heading heap help hex hierarchy high high_priority hosts hour hours http id ident_current ident_incr ident_seed identified identity idle_time if ifnull ignore iif ilike ilm immediate import in include including increment index indexes indexing indextype indicator indices inet6_aton inet6_ntoa inet_aton inet_ntoa infile initial initialized initially initrans inmemory inner innodb input insert install instance instantiable instr interface interleaved intersect into invalidate invisible is is_free_lock is_ipv4 is_ipv4_compat is_not is_not_null is_used_lock isdate isnull isolation iterate java join json json_exists keep keep_duplicates key keys kill language large last last_day last_insert_id last_value lateral lax lcase lead leading least leaves left len lenght length less level levels library like like2 like4 likec limit lines link list listagg little ln load load_file lob lobs local localtime localtimestamp locate locator lock locked log log10 log2 logfile logfiles logging logical logical_reads_per_call logoff logon logs long loop low low_priority lower lpad lrtrim ltrim main make_set makedate maketime managed management manual map mapping mask master master_pos_wait match matched materialized max maxextents maximize maxinstances maxlen maxlogfiles maxloghistory maxlogmembers maxsize maxtrans md5 measures median medium member memcompress memory merge microsecond mid migration min minextents minimum mining minus minute minutes minvalue missing mod mode model modification modify module monitoring month months mount move movement multiset mutex name name_const names nan national native natural nav nchar nclob nested never new newline next nextval no no_write_to_binlog noarchivelog noaudit nobadfile nocheck nocompress nocopy nocycle nodelay nodiscardfile noentityescaping noguarantee nokeep nologfile nomapping nomaxvalue nominimize nominvalue nomonitoring none noneditionable nonschema noorder nopr nopro noprom nopromp noprompt norely noresetlogs noreverse normal norowdependencies noschemacheck noswitch not nothing notice notnull notrim novalidate now nowait nth_value nullif nulls num numb numbe nvarchar nvarchar2 object ocicoll ocidate ocidatetime ociduration ociinterval ociloblocator ocinumber ociref ocirefcursor ocirowid ocistring ocitype oct octet_length of off offline offset oid oidindex old on online only opaque open operations operator optimal optimize option optionally or oracle oracle_date oradata ord ordaudio orddicom orddoc order ordimage ordinality ordvideo organization orlany orlvary out outer outfile outline output over overflow overriding package pad parallel parallel_enable parameters parent parse partial partition partitions pascal passing password password_grace_time password_lock_time password_reuse_max password_reuse_time password_verify_function patch path patindex pctincrease pctthreshold pctused pctversion percent percent_rank percentile_cont percentile_disc performance period period_add period_diff permanent physical pi pipe pipelined pivot pluggable plugin policy position post_transaction pow power pragma prebuilt precedes preceding precision prediction prediction_cost prediction_details prediction_probability prediction_set prepare present preserve prior priority private private_sga privileges procedural procedure procedure_analyze processlist profiles project prompt protection public publishingservername purge quarter query quick quiesce quota quotename radians raise rand range rank raw read reads readsize rebuild record records recover recovery recursive recycle redo reduced ref reference referenced references referencing refresh regexp_like register regr_avgx regr_avgy regr_count regr_intercept regr_r2 regr_slope regr_sxx regr_sxy reject rekey relational relative relaylog release release_lock relies_on relocate rely rem remainder rename repair repeat replace replicate replication required reset resetlogs resize resource respect restore restricted result result_cache resumable resume retention return returning returns reuse reverse revoke right rlike role roles rollback rolling rollup round row row_count rowdependencies rowid rownum rows rtrim rules safe salt sample save savepoint sb1 sb2 sb4 scan schema schemacheck scn scope scroll sdo_georaster sdo_topo_geometry search sec_to_time second seconds section securefile security seed segment select self semi sequence sequential serializable server servererror session session_user sessions_per_user set sets settings sha sha1 sha2 share shared shared_pool short show shrink shutdown si_averagecolor si_colorhistogram si_featurelist si_positionalcolor si_stillimage si_texture siblings sid sign sin size size_t sizes skip slave sleep smalldatetimefromparts smallfile snapshot some soname sort soundex source space sparse spfile split sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_small_result sql_variant_property sqlcode sqldata sqlerror sqlname sqlstate sqrt square standalone standby start starting startup statement static statistics stats_binomial_test stats_crosstab stats_ks_test stats_mode stats_mw_test stats_one_way_anova stats_t_test_ stats_t_test_indep stats_t_test_one stats_t_test_paired stats_wsr_test status std stddev stddev_pop stddev_samp stdev stop storage store stored str str_to_date straight_join strcmp strict string struct stuff style subdate subpartition subpartitions substitutable substr substring subtime subtring_index subtype success sum suspend switch switchoffset switchover sync synchronous synonym sys sys_xmlagg sysasm sysaux sysdate sysdatetimeoffset sysdba sysoper system system_user sysutcdatetime table tables tablespace tablesample tan tdo template temporary terminated tertiary_weights test than then thread through tier ties time time_format time_zone timediff timefromparts timeout timestamp timestampadd timestampdiff timezone_abbr timezone_minute timezone_region to to_base64 to_date to_days to_seconds todatetimeoffset trace tracking transaction transactional translate translation treat trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse type ub1 ub2 ub4 ucase unarchived unbounded uncompress under undo unhex unicode uniform uninstall union unique unix_timestamp unknown unlimited unlock unnest unpivot unrecoverable unsafe unsigned until untrusted unusable unused update updated upgrade upped upper upsert url urowid usable usage use use_stored_outlines user user_data user_resources users using utc_date utc_timestamp uuid uuid_short validate validate_password_strength validation valist value values var var_samp varcharc vari varia variab variabl variable variables variance varp varraw varrawc varray verify version versions view virtual visible void wait wallet warning warnings week weekday weekofyear wellformed when whene whenev wheneve whenever where while whitespace window with within without work wrapped xdb xml xmlagg xmlattributes xmlcast xmlcolattval xmlelement xmlexists xmlforest xmlindex xmlnamespaces xmlpi xmlquery xmlroot xmlschema xmlserialize xmltable xmltype xor year year_to_month years yearweek",literal:"true false null unknown",built_in:"array bigint binary bit blob bool boolean char character date dec decimal float int int8 integer interval number numeric real record serial serial8 smallint text time timestamp tinyint varchar varchar2 varying void"},contains:[{className:"string",begin:"'",end:"'",contains:[{begin:"''"}]},{className:"string",begin:'"',end:'"',contains:[{begin:'""'}]},{className:"string",begin:"`",end:"`"},e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE,n,e.HASH_COMMENT_MODE]},e.C_BLOCK_COMMENT_MODE,n,e.HASH_COMMENT_MODE]}}function A(e){var n={keyword:"#available #colorLiteral #column #else #elseif #endif #file #fileLiteral #function #if #imageLiteral #line #selector #sourceLocation _ __COLUMN__ __FILE__ __FUNCTION__ __LINE__ Any as as! as? associatedtype associativity break case catch class continue convenience default defer deinit didSet do dynamic dynamicType else enum extension fallthrough false fileprivate final for func get guard if import in indirect infix init inout internal is lazy left let mutating nil none nonmutating open operator optional override postfix precedence prefix private protocol Protocol public repeat required rethrows return right self Self set static struct subscript super switch throw throws true try try! try? Type typealias unowned var weak where while willSet",literal:"true false nil",built_in:"abs advance alignof alignofValue anyGenerator assert assertionFailure bridgeFromObjectiveC bridgeFromObjectiveCUnconditional bridgeToObjectiveC bridgeToObjectiveCUnconditional c contains count countElements countLeadingZeros debugPrint debugPrintln distance dropFirst dropLast dump encodeBitsAsWords enumerate equal fatalError filter find getBridgedObjectiveCType getVaList indices insertionSort isBridgedToObjectiveC isBridgedVerbatimToObjectiveC isUniquelyReferenced isUniquelyReferencedNonObjC join lazy lexicographicalCompare map max maxElement min minElement numericCast overlaps partition posix precondition preconditionFailure print println quickSort readLine reduce reflect reinterpretCast reverse roundUpToAlignment sizeof sizeofValue sort split startsWith stride strideof strideofValue swap toString transcode underestimateCount unsafeAddressOf unsafeBitCast unsafeDowncast unsafeUnwrap unsafeReflect withExtendedLifetime withObjectAtPlusZero withUnsafePointer withUnsafePointerToObject withUnsafeMutablePointer withUnsafeMutablePointers withUnsafePointer withUnsafePointers withVaList zip"},a=e.COMMENT("/\\*","\\*/",{contains:["self"]}),t={className:"subst",begin:/\\\(/,end:"\\)",keywords:n,contains:[]},i={className:"string",contains:[e.BACKSLASH_ESCAPE,t],variants:[{begin:/"""/,end:/"""/},{begin:/"/,end:/"/}]},s={className:"number",begin:"\\b([\\d_]+(\\.[\\deE_]+)?|0x[a-fA-F0-9_]+(\\.[a-fA-F0-9p_]+)?|0b[01_]+|0o[0-7_]+)\\b",relevance:0};return t.contains=[s],{keywords:n,contains:[i,e.C_LINE_COMMENT_MODE,a,{className:"type",begin:"\\b[A-Z][\\wÀ-ʸ']*[!?]"},{className:"type",begin:"\\b[A-Z][\\wÀ-ʸ']*",relevance:0},s,{className:"function",beginKeywords:"func",end:"{",excludeEnd:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/[A-Za-z$_][0-9A-Za-z$_]*/}),{begin://},{className:"params",begin:/\(/,end:/\)/,endsParent:!0,keywords:n,contains:["self",s,i,e.C_BLOCK_COMMENT_MODE,{begin:":"}],illegal:/["']/}],illegal:/\[|%/},{className:"class",beginKeywords:"struct protocol class extension enum",keywords:n,end:"\\{",excludeEnd:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/[A-Za-z$_][\u00C0-\u02B80-9A-Za-z$_]*/})]},{className:"meta",begin:"(@discardableResult|@warn_unused_result|@exported|@lazy|@noescape|@NSCopying|@NSManaged|@objc|@objcMembers|@convention|@required|@noreturn|@IBAction|@IBDesignable|@IBInspectable|@IBOutlet|@infix|@prefix|@postfix|@autoclosure|@testable|@available|@nonobjc|@NSApplicationMain|@UIApplicationMain|@dynamicMemberLookup|@propertyWrapper)"},{beginKeywords:"import",end:/$/,contains:[e.C_LINE_COMMENT_MODE,a]}]}}function R(e){var n={className:"symbol",begin:"&[a-z]+;|&#[0-9]+;|&#x[a-f0-9]+;"},a={begin:"\\s",contains:[{className:"meta-keyword",begin:"#?[a-z_][a-z1-9_-]+",illegal:"\\n"}]},t=e.inherit(a,{begin:"\\(",end:"\\)"}),i=e.inherit(e.APOS_STRING_MODE,{className:"meta-string"}),s=e.inherit(e.QUOTE_STRING_MODE,{className:"meta-string"}),r={endsWithParent:!0,illegal:/`]+/}]}]}]};return{aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist","wsf","svg"],case_insensitive:!0,contains:[{className:"meta",begin:"",relevance:10,contains:[a,s,i,t,{begin:"\\[",end:"\\]",contains:[{className:"meta",begin:"",contains:[a,t,s,i]}]}]},e.COMMENT("\x3c!--","--\x3e",{relevance:10}),{begin:"<\\!\\[CDATA\\[",end:"\\]\\]>",relevance:10},n,{className:"meta",begin:/<\?xml/,end:/\?>/,relevance:10},{begin:/<\?(php)?/,end:/\?>/,subLanguage:"php",contains:[{begin:"/\\*",end:"\\*/",skip:!0},{begin:'b"',end:'"',skip:!0},{begin:"b'",end:"'",skip:!0},e.inherit(e.APOS_STRING_MODE,{illegal:null,className:null,contains:null,skip:!0}),e.inherit(e.QUOTE_STRING_MODE,{illegal:null,className:null,contains:null,skip:!0})]},{className:"tag",begin:")",end:">",keywords:{name:"style"},contains:[r],starts:{end:"",returnEnd:!0,subLanguage:["css","xml"]}},{className:"tag",begin:")",end:">",keywords:{name:"script"},contains:[r],starts:{end:"<\/script>",returnEnd:!0,subLanguage:["actionscript","javascript","handlebars","xml"]}},{className:"tag",begin:"",contains:[{className:"name",begin:/[^\/><\s]+/,relevance:0},r]}]}}function B(e){var n="true false yes no null",a={className:"string",relevance:0,variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/\S+/}],contains:[e.BACKSLASH_ESCAPE,{className:"template-variable",variants:[{begin:"{{",end:"}}"},{begin:"%{",end:"}"}]}]};return{case_insensitive:!0,aliases:["yml","YAML","yaml"],contains:[{className:"attr",variants:[{begin:"\\w[\\w :\\/.-]*:(?=[ \t]|$)"},{begin:'"\\w[\\w :\\/.-]*":(?=[ \t]|$)'},{begin:"'\\w[\\w :\\/.-]*':(?=[ \t]|$)"}]},{className:"meta",begin:"^---s*$",relevance:10},{className:"string",begin:"[\\|>]([0-9]?[+-])?[ ]*\\n( *)[\\S ]+\\n(\\2[\\S ]+\\n?)*"},{begin:"<%[%=-]?",end:"[%-]?%>",subLanguage:"ruby",excludeBegin:!0,excludeEnd:!0,relevance:0},{className:"type",begin:"!"+e.UNDERSCORE_IDENT_RE},{className:"type",begin:"!!"+e.UNDERSCORE_IDENT_RE},{className:"meta",begin:"&"+e.UNDERSCORE_IDENT_RE+"$"},{className:"meta",begin:"\\*"+e.UNDERSCORE_IDENT_RE+"$"},{className:"bullet",begin:"\\-(?=[ ]|$)",relevance:0},e.HASH_COMMENT_MODE,{beginKeywords:n,keywords:{literal:n}},{className:"number",begin:e.C_NUMBER_RE+"\\b"},a]}}var D,L,I={};D=function(t){var a,g=[],s=Object.keys,w=Object.create(null),r=Object.create(null),O=!0,n=/^(no-?highlight|plain|text)$/i,l=/\blang(?:uage)?-([\w-]+)\b/i,i=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,M="",x="Could not find the language '{}', did you forget to load/include a language module?",C={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0},o="of and for in not or if then".split(" ");function S(e){return e.replace(/&/g,"&").replace(//g,">")}function u(e){return e.nodeName.toLowerCase()}function c(e){return n.test(e)}function d(e){var n,a={},t=Array.prototype.slice.call(arguments,1);for(n in e)a[n]=e[n];return t.forEach(function(e){for(n in e)a[n]=e[n]}),a}function _(e){var i=[];return function e(n,a){for(var t=n.firstChild;t;t=t.nextSibling)3===t.nodeType?a+=t.nodeValue.length:1===t.nodeType&&(i.push({event:"start",offset:a,node:t}),a=e(t,a),u(t).match(/br|hr|img|input/)||i.push({event:"stop",offset:a,node:t}));return a}(e,0),i}function m(e,n,a){var t=0,i="",s=[];function r(){return e.length&&n.length?e[0].offset!==n[0].offset?e[0].offset"}function o(e){i+=""}function c(e){("start"===e.event?l:o)(e.node)}for(;e.length||n.length;){var d=r();if(i+=S(a.substring(t,d[0].offset)),t=d[0].offset,d===e){for(s.reverse().forEach(o);c(d.splice(0,1)[0]),(d=r())===e&&d.length&&d[0].offset===t;);s.reverse().forEach(l)}else"start"===d[0].event?s.push(d[0].node):s.pop(),c(d.splice(0,1)[0])}return i+S(a.substr(t))}function b(n){return n.variants&&!n.cached_variants&&(n.cached_variants=n.variants.map(function(e){return d(n,{variants:null},e)})),n.cached_variants||(function e(n){return!!n&&(n.endsWithParent||e(n.starts))}(n)?[d(n,{starts:n.starts?d(n.starts):null})]:Object.isFrozen(n)?[d(n)]:[n])}function p(e){if(a&&!e.langApiRestored){for(var n in e.langApiRestored=!0,a)e[n]&&(e[a[n]]=e[n]);(e.contains||[]).concat(e.variants||[]).forEach(p)}}function f(n,t){var i={};return"string"==typeof n?a("keyword",n):s(n).forEach(function(e){a(e,n[e])}),i;function a(a,e){(e=t?e.toLowerCase():e).split(" ").forEach(function(e){var n,e=e.split("|");i[e[0]]=[a,(n=e[0],(e=e[1])?Number(e):function(e){return-1!=o.indexOf(e.toLowerCase())}(n)?0:1)]})}}function T(t){function d(e){return e&&e.source||e}function g(e,n){return new RegExp(d(e),"m"+(t.case_insensitive?"i":"")+(n?"g":""))}function i(i){var s={},r=[],l={},a=1;function e(e,n){s[a]=e,r.push([e,n]),a+=new RegExp(n.toString()+"|").exec("").length-1+1}for(var n=0;n')+n+(a?"":M)):n:""}function r(){var e,n,a,t,i;if(!m.keywords)return S(E);for(a="",m.lexemesRe.lastIndex=e=0,n=m.lexemesRe.exec(E);n;)a+=S(E.substring(e,n.index)),t=m,i=n,i=_.case_insensitive?i[0].toLowerCase():i[0],(t=t.keywords.hasOwnProperty(i)&&t.keywords[i])?(N+=t[1],a+=s(t[0],S(n[0]))):a+=S(n[0]),e=m.lexemesRe.lastIndex,n=m.lexemesRe.exec(E);return a+S(E.substr(e))}function l(){var e,n;p+=null!=m.subLanguage?(n="string"==typeof m.subLanguage)&&!w[m.subLanguage]?S(E):(e=n?k(m.subLanguage,E,!0,b[m.subLanguage]):A(E,m.subLanguage.length?m.subLanguage:void 0),0")+'"');if("end"===n.type){e=d(n);if(null!=e)return e}return E+=a,a.length}var _=R(n);if(!_)throw console.error(x.replace("{}",n)),new Error('Unknown language: "'+n+'"');T(_);for(var m=a||_,b={},p="",f=m;f!==_;f=f.parent)f.className&&(p=s(f.className,"",!0)+p);var E="",N=0;try{for(var h,v,y=0;;){if(m.terminators.lastIndex=y,!(h=m.terminators.exec(i)))break;v=u(i.substring(y,h.index),h),y=h.index+v}for(u(i.substr(y)),f=m;f.parent;f=f.parent)f.className&&(p+=M);return{relevance:N,value:p,illegal:!1,language:n,top:m}}catch(e){if(e.message&&-1!==e.message.indexOf("Illegal"))return{illegal:!0,relevance:0,value:S(i)};if(O)return{relevance:0,value:S(i),language:n,top:m,errorRaised:e};throw e}}function A(a,e){e=e||C.languages||s(w);var t={relevance:0,value:S(a)},i=t;return e.filter(R).filter(y).forEach(function(e){var n=k(e,a,!1);n.language=e,n.relevance>i.relevance&&(i=n),n.relevance>t.relevance&&(i=t,t=n)}),i.language&&(t.second_best=i),t}function E(e){return C.tabReplace||C.useBR?e.replace(i,function(e,n){return C.useBR&&"\n"===e?"
":C.tabReplace?n.replace(/\t/g,C.tabReplace):""}):e}function N(e){var n,a,t,i,s=function(e){var n,a,t,i,s,r=e.className+" ";if(r+=e.parentNode?e.parentNode.className:"",a=l.exec(r))return(s=R(a[1]))||(console.warn(x.replace("{}",a[1])),console.warn("Falling back to no-highlight mode for this block.",e)),s?a[1]:"no-highlight";for(n=0,t=(r=r.split(/\s+/)).length;n/g,"\n"):a=e,i=a.textContent,n=s?k(s,i,!0):A(i),(a=_(a)).length&&((t=document.createElement("div")).innerHTML=n.value,n.value=m(a,_(t),i)),n.value=E(n.value),e.innerHTML=n.value,e.className=(a=e.className,t=s,i=n.language,t=t?r[t]:i,i=[a.trim()],a.match(/\bhljs\b/)||i.push("hljs"),-1===a.indexOf(t)&&i.push(t),i.join(" ").trim()),e.result={language:n.language,re:n.relevance},n.second_best&&(e.second_best={language:n.second_best.language,re:n.second_best.relevance}))}function h(){var e;h.called||(h.called=!0,e=document.querySelectorAll("pre code"),g.forEach.call(e,N))}var v={disableAutodetect:!0};function R(e){return e=(e||"").toLowerCase(),w[e]||w[r[e]]}function y(e){e=R(e);return e&&!e.disableAutodetect}return t.highlight=k,t.highlightAuto=A,t.fixMarkup=E,t.highlightBlock=N,t.configure=function(e){C=d(C,e)},t.initHighlighting=h,t.initHighlightingOnLoad=function(){window.addEventListener("DOMContentLoaded",h,!1),window.addEventListener("load",h,!1)},t.registerLanguage=function(n,e){var a;try{a=e(t)}catch(e){if(console.error("Language definition for '{}' could not be registered.".replace("{}",n)),!O)throw e;console.error(e),a=v}p(w[n]=a),a.rawDefinition=e.bind(null,t),a.aliases&&a.aliases.forEach(function(e){r[e]=n})},t.listLanguages=function(){return s(w)},t.getLanguage=R,t.requireLanguage=function(e){var n=R(e);if(n)return n;throw new Error("The '{}' language is required, but not loaded.".replace("{}",e))},t.autoDetection=y,t.inherit=d,t.debugMode=function(){O=!1},t.IDENT_RE="[a-zA-Z]\\w*",t.UNDERSCORE_IDENT_RE="[a-zA-Z_]\\w*",t.NUMBER_RE="\\b\\d+(\\.\\d+)?",t.C_NUMBER_RE="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",t.BINARY_NUMBER_RE="\\b(0b[01]+)",t.RE_STARTERS_RE="!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",t.BACKSLASH_ESCAPE={begin:"\\\\[\\s\\S]",relevance:0},t.APOS_STRING_MODE={className:"string",begin:"'",end:"'",illegal:"\\n",contains:[t.BACKSLASH_ESCAPE]},t.QUOTE_STRING_MODE={className:"string",begin:'"',end:'"',illegal:"\\n",contains:[t.BACKSLASH_ESCAPE]},t.PHRASAL_WORDS_MODE={begin:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/},t.COMMENT=function(e,n,a){e=t.inherit({className:"comment",begin:e,end:n,contains:[]},a||{});return e.contains.push(t.PHRASAL_WORDS_MODE),e.contains.push({className:"doctag",begin:"(?:TODO|FIXME|NOTE|BUG|XXX):",relevance:0}),e},t.C_LINE_COMMENT_MODE=t.COMMENT("//","$"),t.C_BLOCK_COMMENT_MODE=t.COMMENT("/\\*","\\*/"),t.HASH_COMMENT_MODE=t.COMMENT("#","$"),t.NUMBER_MODE={className:"number",begin:t.NUMBER_RE,relevance:0},t.C_NUMBER_MODE={className:"number",begin:t.C_NUMBER_RE,relevance:0},t.BINARY_NUMBER_MODE={className:"number",begin:t.BINARY_NUMBER_RE,relevance:0},t.CSS_NUMBER_MODE={className:"number",begin:t.NUMBER_RE+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",relevance:0},t.REGEXP_MODE={className:"regexp",begin:/\//,end:/\/[gimuy]*/,illegal:/\n/,contains:[t.BACKSLASH_ESCAPE,{begin:/\[/,end:/\]/,relevance:0,contains:[t.BACKSLASH_ESCAPE]}]},t.TITLE_MODE={className:"title",begin:t.IDENT_RE,relevance:0},t.UNDERSCORE_TITLE_MODE={className:"title",begin:t.UNDERSCORE_IDENT_RE,relevance:0},t.METHOD_GUARD={begin:"\\.\\s*"+t.UNDERSCORE_IDENT_RE,relevance:0},[t.BACKSLASH_ESCAPE,t.APOS_STRING_MODE,t.QUOTE_STRING_MODE,t.PHRASAL_WORDS_MODE,t.COMMENT,t.C_LINE_COMMENT_MODE,t.C_BLOCK_COMMENT_MODE,t.HASH_COMMENT_MODE,t.NUMBER_MODE,t.C_NUMBER_MODE,t.BINARY_NUMBER_MODE,t.CSS_NUMBER_MODE,t.REGEXP_MODE,t.TITLE_MODE,t.UNDERSCORE_TITLE_MODE,t.METHOD_GUARD].forEach(function(e){!function n(a){Object.freeze(a);var t="function"==typeof a;Object.getOwnPropertyNames(a).forEach(function(e){!a.hasOwnProperty(e)||null===a[e]||"object"!=typeof a[e]&&"function"!=typeof a[e]||t&&("caller"===e||"callee"===e||"arguments"===e)||Object.isFrozen(a[e])||n(a[e])});return a}(e)}),t},L="object"==typeof window&&window||"object"==typeof self&&self,void 0===I||I.nodeType?L&&(L.hljs=D({}),"function"==typeof define)&&define.amd&&define([],function(){return L.hljs}):D(I);!function(){"use strict";I.registerLanguage("asciidoc",e),I.registerLanguage("bash",n),I.registerLanguage("clojure",a),I.registerLanguage("cpp",t),I.registerLanguage("cs",i),I.registerLanguage("css",s),I.registerLanguage("diff",r),I.registerLanguage("dockerfile",l),I.registerLanguage("elixir",o),I.registerLanguage("go",c),I.registerLanguage("groovy",d),I.registerLanguage("haskell",g),I.registerLanguage("java",u),I.registerLanguage("javascript",_),I.registerLanguage("json",m),I.registerLanguage("kotlin",b),I.registerLanguage("lua",p),I.registerLanguage("markdown",f),I.registerLanguage("nix",E),I.registerLanguage("none",N),I.registerLanguage("objectivec",h),I.registerLanguage("perl",v),I.registerLanguage("php",y),I.registerLanguage("properties",w),I.registerLanguage("puppet",O),I.registerLanguage("python",M),I.registerLanguage("ruby",x),I.registerLanguage("rust",C),I.registerLanguage("scala",S),I.registerLanguage("shell",T),I.registerLanguage("sql",k),I.registerLanguage("swift",A),I.registerLanguage("xml",R),I.registerLanguage("yaml",B),[].slice.call(document.querySelectorAll("pre code.hljs[data-lang]")).forEach(function(e){I.highlightBlock(e)})}()}(); \ No newline at end of file diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/01_quay-ac-settings.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/01_quay-ac-settings.png deleted file mode 100644 index aa3d33f..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/01_quay-ac-settings.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/02-gen-username-password.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/02-gen-username-password.png deleted file mode 100644 index 7a9f06c..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/02-gen-username-password.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/02_generate-enc-pwd.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/02_generate-enc-pwd.png deleted file mode 100644 index a2c36a2..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/02_generate-enc-pwd.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/03-rhdp-cluster-details.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/03-rhdp-cluster-details.png deleted file mode 100644 index a930b78..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/03-rhdp-cluster-details.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/03_generate-kube-secret.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/03_generate-kube-secret.png deleted file mode 100644 index 3c1a347..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/03_generate-kube-secret.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/04_ocp-import-yaml.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/04_ocp-import-yaml.png deleted file mode 100644 index 56d5229..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/04_ocp-import-yaml.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/05_ocp-pull-secret.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/05_ocp-pull-secret.png deleted file mode 100644 index 0494043..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/05_ocp-pull-secret.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/06_ocp-import-helm-chart.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/06_ocp-import-helm-chart.png deleted file mode 100644 index 85c273c..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/06_ocp-import-helm-chart.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/07_ocp-rhdh-helm-chart.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/07_ocp-rhdh-helm-chart.png deleted file mode 100644 index 18c5977..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/07_ocp-rhdh-helm-chart.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/08_rhdh-helm-details.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/08_rhdh-helm-details.png deleted file mode 100644 index b397130..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/08_rhdh-helm-details.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/09_rhdh-helm-form.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/09_rhdh-helm-form.png deleted file mode 100644 index 9a12ab5..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/09_rhdh-helm-form.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/10_rhdh-helm-installing.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/10_rhdh-helm-installing.png deleted file mode 100644 index eecb8c1..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/10_rhdh-helm-installing.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/12_rhdh-console-access-1.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/12_rhdh-console-access-1.png deleted file mode 100644 index fbba35a..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/12_rhdh-console-access-1.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/13_rhdh-first-login-prompt.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/13_rhdh-first-login-prompt.png deleted file mode 100644 index 430ae6e..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/13_rhdh-first-login-prompt.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/14_rhdh-guest-login-home.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/14_rhdh-guest-login-home.png deleted file mode 100644 index 1d3223b..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/14_rhdh-guest-login-home.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/15_rhdh-auth-providers.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/15_rhdh-auth-providers.png deleted file mode 100644 index 36e809f..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/15_rhdh-auth-providers.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/add-helm-chart.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/add-helm-chart.png deleted file mode 100644 index 09d8f89..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/add-helm-chart.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/cli-tools.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/cli-tools.png deleted file mode 100644 index 3cdb7e4..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/cli-tools.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/del-rhdh-op-instance.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/del-rhdh-op-instance.png deleted file mode 100644 index 88227c5..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/del-rhdh-op-instance.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/edit-helm-chart-values.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/edit-helm-chart-values.png deleted file mode 100644 index efe65ce..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/edit-helm-chart-values.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/edit-secret-yaml.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/edit-secret-yaml.png deleted file mode 100644 index c491cbf..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/edit-secret-yaml.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/helm-release-delete.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/helm-release-delete.png deleted file mode 100644 index c3fd7b6..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/helm-release-delete.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/helm-release-upgrade.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/helm-release-upgrade.png deleted file mode 100644 index f3e6eed..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/helm-release-upgrade.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/import-yaml-icon.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/import-yaml-icon.png deleted file mode 100644 index b2824d7..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/import-yaml-icon.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/new-ocp-project.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/new-ocp-project.png deleted file mode 100644 index 43194cb..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/new-ocp-project.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/op-upgrade.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/op-upgrade.png deleted file mode 100644 index eb76f3d..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/op-upgrade.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-create-op-instance.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-create-op-instance.png deleted file mode 100644 index fa80b34..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-create-op-instance.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-guest-user.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-guest-user.png deleted file mode 100644 index 6571275..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-guest-user.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-homepage.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-homepage.png deleted file mode 100644 index a00ce06..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-homepage.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-installed.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-installed.png deleted file mode 100644 index 2375f85..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-installed.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-details.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-details.png deleted file mode 100644 index 3136e18..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-details.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-installed.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-installed.png deleted file mode 100644 index 73d68ac..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-installed.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-instance-running.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-instance-running.png deleted file mode 100644 index ff17cb8..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-op-instance-running.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-operator-installed.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-operator-installed.png deleted file mode 100644 index 5ce24e0..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-operator-installed.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-pod-details-error.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-pod-details-error.png deleted file mode 100644 index a04d8cc..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-pod-details-error.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-pod-error.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-pod-error.png deleted file mode 100644 index e4a8b37..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/rhdh-pod-error.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/search-devhub-chart.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/search-devhub-chart.png deleted file mode 100644 index 8ff3114..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/search-devhub-chart.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/search-devhub-operator.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/search-devhub-operator.png deleted file mode 100644 index bfdf6f6..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/search-devhub-operator.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/select-chart-upgrade.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/select-chart-upgrade.png deleted file mode 100644 index 4ead306..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/select-chart-upgrade.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/switch-dev-perspective.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/switch-dev-perspective.png deleted file mode 100644 index fb9a881..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/switch-dev-perspective.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/uninstall-rhdh-op.png b/pr-preview/pr-13/devhub-admin/1/chapter1/_images/uninstall-rhdh-op.png deleted file mode 100644 index a271e9c..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter1/_images/uninstall-rhdh-op.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/index.html b/pr-preview/pr-13/devhub-admin/1/chapter1/index.html deleted file mode 100644 index 9bc976a..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter1/index.html +++ /dev/null @@ -1,158 +0,0 @@ - - - - - - Installation, Upgrades and Uninstallation :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Installation, Upgrades and Uninstallation

-
-

In this chapter, you will learn how to install Red Hat Developer Hub (RHDH) on OpenShift using different methods:

-
-
-
    -
  • -

    Installation using Helm charts

    -
    • -
  • -

    Installation using the Red Hat Developer Hub Operator

    -
    • -
  • -

    Installation using the CLI

    -
    • -
-
-
-

You will also learn how to upgrade and uninstall RHDH.

-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/install-helm.html b/pr-preview/pr-13/devhub-admin/1/chapter1/install-helm.html deleted file mode 100644 index 1773ea0..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter1/install-helm.html +++ /dev/null @@ -1,480 +0,0 @@ - - - - - - Red Hat Developer Hub Installation using Helm Charts :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Red Hat Developer Hub Installation using Helm Charts

-
-
-
-

Red Hat builds and ships RHDH as a container image that is based on the Red Hat Enterprise Linux Universal Base Image (RHEL UBI).

-
-
-

There are several ways to install RHDH on OpenShift. This section covers installation using Helm charts. The next section covers installation using the RHDH Operator from OperatorHub.

-
-
-
-
-

Installation Using Helm Charts

-
-
-

The Red Hat Developer Hub helm chart is available in the Helm Catalog in Openshift, and on ArtifactHUB (A repository of Helm Charts).

-
-
-

A short refresher on how to work with Helm Charts on OpenShift is here.

-
-
-

The source code, templates, and the values.yaml file for the helm chart are available here for inspection. -The chart contains an opinionated default configuration of Backstage with a pre-integrated set of useful plugins, and it also uses a PostgreSQL database to persist the configuration state of RHDH.

-
-
-
-
-

Lab: Installation using Helm Charts

-
-
-

Pre-requisites

-
-
    -
  1. -

    Order the OpenShift Single Node Cluster catalog item from Red Hat Demo Platform (RHDP). It should take approximately an hour for the classroom to be fully provisioned. You will receive an email with the details on how to access the OpenShift cluster. Verify that you can log in to the OpenShift web console as a cluster administrator.

    -
    2. -
-
-
-
-

Create a Project for RHDH

-
-
    -
  1. -

    Log in to your OpenShift web console as the cluster administrator user (usually username is admin). The username and password details for your OpenShift cluster are accessible in the RHDP Services dashboard. You should have also received an email with the details of your OpenShift cluster.

    -
    -
    -03 rhdp cluster details -
    -
    Figure 1. RHDP OpenShift Cluster Details
    -
    -
    - - - - - -
    - - -
    -

    You can install the RHDH Helm chart as a regular, non-cluster administrator user, but this is not recommended. Many organizations have strict policies on who can install operators and charts in the OpenShift cluster.

    -
    -
    -
    -
    2. -
  2. -

    Click on Home > Projects (Ensure you are in the Administrator perspective of the OpenShift console). Click Create Project, and then create a new OpenShift project named devhub.

    -
    -
    -new ocp project -
    -
    Figure 2. Create a new OpenShift Project
    -
    -
    3. -
-
-
-
-

Install the RHDH Helm Chart

-
-
    -
  1. -

    Switch to the Developer perspective in the OpenShift console and select the devhub project.

    -
    -
    -switch dev perspective -
    -
    Figure 3. Switch to the Developer Perspective
    -
    -
    2. -
  2. -

    Click +Add in the left side navigation bar of the Developer perspective, and then select Helm Chart

    -
    -
    -add helm chart -
    -
    Figure 4. Add Helm Chart
    -
    -
    3. -
  3. -

    Search for "developer hub" in the search field on this page, and then select the Red Hat Developer Hub chart.

    -
    -
    -search devhub chart -
    -
    Figure 5. Search for RHDH Helm Chart
    -
    -
    4. -
  4. -

    In the Red Hat Developer Hub chart page, click Create. You will see the Create Helm Release page with some fields that need to be edited.

    -
    -
      -
    1. -

      Change the Release Name to rhdh. Ensure that the latest helm chart is selected in the Chart version drop-down (As of Jun 2024, latest RHDH version is 1.2.1).

      -
      2. -
    2. -

      Expand Root Schema > global and change the first field value from apps.example.com to the wildcard domain name of your OpenShift cluster. In RHDP, it is in the format apps.cluster-<guid>.dynamic.redhatworkshops.io, where <guid> is unique to your provisioned OpenShift cluster.

      -
      3. -
    3. -

      The final screen should look like the following:

      -
      -
      -edit helm chart values -
      -
      Figure 6. Edit Helm Chart Details
      -
      -
      4. -
    4. -

      Click Create to deploy the helm chart.

      -
      5. -
    -
    -
    5. -
  5. -

    Wait for 10-15 minutes while the helm chart is deployed. The PostgreSQL and Red Hat Developer Hub pods should be fully started (dark blue circles around the icons). -Click the Open URL link to access Red Hat Developer Hub.

    -
    -
    -rhdh installed -
    -
    Figure 7. RHDH Topology View
    -
    -
    6. -
  6. -

    You should now see the Red Hat Developer Hub log in page.

    -
    -
    -rhdh homepage -
    -
    Figure 8. RHDH Log in Page
    -
    -
    7. -
  7. -

    Click Enter in the Guest card to log in as a guest user. You will a warning message pop up with the text Failed to sign in as a guest using the auth backend. Do you want to fallback to the legacy guest token?. Click Yes to log in as a guest user. -You will configure RHDH to authenticate against GitHub and other identity providers in later chapters of this course.

    -
    -
    -rhdh guest user -
    -
    Figure 9. Log in as a guest user
    -
    -
    -

    You have now successfully installed Red Hat Developer Hub on your OpenShift cluster.

    -
    -
    8. -
-
-
-
-
-
-

Installation using Helm CLI

-
-
-

Download the helm and oc CLI tools from the OpenShift web console by clicking the "?" icon on the top right navigation bar. Uncompress the archive files, and then copy the oc and helm binaries for your platform to the system path (usually /usr/local/bin on UNIX systems).

-
-
-
-cli tools -
-
Figure 10. Download CLI Tools
-
-
-

CLI Install Steps

-
-
    -
  1. -

    Add the OpenShift helm chart repository

    -
    -
    -
    $ helm repo add openshift-helm-charts https://charts.openshift.io/
    -
    -
    -
    2. -
  2. -

    Download the default values.yaml file for the RHDH helm chart

    -
    -
    -
    $ helm show values \
-  openshift-helm-charts/redhat-developer-hub \
-  --version 1.2.1 > /tmp/values.yaml
    -
    -
    -
    3. -
  3. -

    Change the value of the global.clusterRouterBase attribute to the wildcard OpenShift DNS name, and also edit the upstream.nameOverride to rhdh.

    -
    -
    -
    global:
-  clusterRouterBase: apps.cluster-<guid>.dynamic.redhatworkshops.io
-  host: ""
-
-upstream:
-  nameOverride: rhdh
-  backstage:
-...
    -
    -
    -
    4. -
  4. -

    Log in to the OpenShift cluster as the cluster administrator. Ensure that you switch to the devhub project.

    -
    -
    -
    $ oc login -u admin \
-    https://api.cluster-<your_guid>.dynamic.redhatworkshops.io:6443
-
-$ oc project devhub
    -
    -
    -
    5. -
  5. -

    Install the RHDH helm chart with the updated values.yaml file

    -
    -
    -
    $ helm upgrade \
-  -i rhdh -f /tmp/values.yaml \
-  openshift-helm-charts/redhat-developer-hub
-
-Release "rhdh" does not exist. Installing it now.
-...
-NAME: rhdh
-LAST DEPLOYED: Thu Jun 27 13:59:33 2024
-NAMESPACE: devhub
-STATUS: deployed
-REVISION: 1
    -
    -
    -
    6. -
  6. -

    Wait for 10-15 minutes while the helm chart is installed. Verify that the rhdh-devhub and rhdh-postgresql pods are in Running state.

    -
    -
    -
    $ oc get pods
-NAME                    READY   STATUS    RESTARTS   AGE
-rhdh-84fb7ddd9d-nvdcf   1/1     Running   0          2m17s
-rhdh-postgresql-0       1/1     Running   0          2m16s
    -
    -
    -
    7. -
  7. -

    Fetch the OpenShift route for RHDH and open the URL in a browser to navigate to the RHDH home page.

    -
    -
    -
    $ oc get route \
-rhdh-redhat-developer-hub \
---output jsonpath={.spec.host}
-
-rhdh-developer-hub-devhub.apps.cluster-<guid>.dynamic.redhatworkshops.io
    -
    -
    -
    8. -
-
-
-
-
-
-

RHDH PostgreSQL Database

-
-
- - - - - -
- - -
-

The default installation of RHDH (for both Helm Charts and Operator based installs) deploys a single PostgreSQL 15 database pod. This is a potential single point of failure and could prevent RHDH from being highly available.

-
-
-

You should follow the installation instructions and install the default single instance PostgreSQL to complete the install. You can then configure the RHDH container to integrate with an external PostgreSQL database instance using the instructions provided in the product documentation at Configuring an external PostgreSQL instance using the Helm Chart.

-
-
-
-
-
-
-

Installation Troubleshooting

-
-
-

The following are some problems you could see during installation, and the potential fix for them.

-
-
-
    -
  1. -

    Problem: The rhdh-developer-hub pod is stuck in a CrashLoopBackOff error with the following seen in the logs:

    -
    -
    -
    Loaded config from app-config-from-configmap.yaml, env
-...
-2023-07-24T19:44:46.223Z auth info Configuring "database" as KeyStore provider
-type=plugin
-Backend failed to start up Error: Missing required config value at
-'backend.database.client'
    -
    -
    -
    -

    Solution: This is happening because the configuration files are not being appropriately accessed by the RHDH container. You may have edited the helm chart values before installation, and one or more attributes are missing or configured incorrectly. It is recommended to keep the default values (except for the wildcard DNS name of the OpenShift cluster) during installation.

    -
    -
    -

    You can always edit and update the RHDH configuration after the installation is completed successfully.

    -
    -
    2. -
  2. -

    Problem: I see the following error when installing the RHDH helm chart using the helm CLI:

    -
    -
    -
    Error: query: failed to query with labels: secrets is forbidden: User "system:anonymous" cannot list resource "secrets" in API group "" in the namespace "devhub"
    -
    -
    -
    -

    Solution: Ensure that you are logged in to the OpenShift cluster as a cluster administrator before installing, removing or upgrading the RHDH helm chart. Also ensure that you are in the correct OpenShift project, so that the resources are created in it.

    -
    -
    3. -
-
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/install-operator.html b/pr-preview/pr-13/devhub-admin/1/chapter1/install-operator.html deleted file mode 100644 index d17113c..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter1/install-operator.html +++ /dev/null @@ -1,306 +0,0 @@ - - - - - - Red Hat Developer Hub Installation using OperatorHub :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Red Hat Developer Hub Installation using OperatorHub

-
-
-
-

Red Hat provides a fully supported operator for RHDH in the OpenShift OperatorHub, which provides a convienient, easy to use web based user interface for installing RHDH.

-
-
-
-
-

Installation Using the RHDH Operator

-
-
-

RHDH can be installed from within the OpenShift web console just like any other operator from OperatorHub.

-
-
-

Refer to the instructions here to install the RHDH operator on OpenShift.

-
-
-
-
-

Lab: Installation using RHDH Operator

-
-
-

Pre-requisites

-
-
    -
  1. -

    Order the OpenShift Single Node Cluster catalog item from Red Hat Demo Platform (RHDP). It should take an hour approximately for the classroom to be fully provisioned. You will receive an email with the details on how to access the OpenShift cluster. Verify that you can log in to the OpenShift web console as a cluster administrator.

    -
    2. -
  2. -

    Download the OpenShift client oc for your platform from from the OpenShift web console by clicking the "?" icon on the top right navigation bar. Uncompress the archive file, and then copy the oc binary for your platform to the system path (usually /usr/local/bin on UNIX systems).

    -
    3. -
-
-
-
-

Create a Project for RHDH

-
-
    -
  1. -

    Log in to your OpenShift web console as the cluster administrator user (usually username is admin). The username and password details for your OpenShift cluster are accessible in the RHDP Services dashboard. You should have also received an email with the details of your OpenShift cluster.

    -
    -
    -03 rhdp cluster details -
    -
    Figure 1. RHDP OpenShift Cluster Details
    -
    -
    2. -
  2. -

    Create a new OpenShift project named devhub. You will install the RHDH operator and instance into this project.

    -
    3. -
-
-
-
-

Install the RHDH Operator

-
-
    -
  1. -

    Click Operators > OperatorHub in the left side navigation bar of the Administrator perspective in the OpenShift web console.

    -
    2. -
  2. -

    Search for "developer hub" in the search field on this page, and then select the Red Hat Developer Hub operator.

    -
    -
    -search devhub operator -
    -
    Figure 2. Search for RHDH Operator
    -
    -
    3. -
  3. -

    In the Red Hat Developer Hub operator details page, click Install. In the Install Operator page, select the devhub project in the Installed Namespace field. Leave all other fields at their default values, and click Install to begin the operator installation.

    -
    -
    -rhdh op details -
    -
    Figure 3. RHDP Operator Details
    -
    -
    4. -
  4. -

    Wait for 5-10 minutes while the operator is installed. You should see Installed operator: ready for use message when the operator is successfully installed.

    -
    -
    -rhdh operator installed -
    -
    Figure 4. RHDH Operator Installed
    -
    -
    5. -
  5. -

    Click View Operator, and then click Create instance to create a new RHDH instance.

    -
    -
    -rhdh create op instance -
    -
    Figure 5. RHDH Create new Instance
    -
    -
    6. -
  6. -

    In the Create Backstage page, change the Name to rhdh, leave all other fields at default values, and then click Create to deploy a new RHDH instance.

    -
    7. -
  7. -

    Switch to the Developer perspective in the OpenShift web console, and select the devhub project. Verify that a new instance called rhdh is seen with two pods in running state.

    -
    -
    -rhdh op instance running -
    -
    Figure 6. RHDH instance running
    -
    -
    8. -
  8. -

    Click the Open URL link to access Red Hat Developer Hub.

    -
    -
    -rhdh op installed -
    -
    Figure 7. RHDH Open URL
    -
    -
    9. -
  9. -

    You should now see the Red Hat Developer Hub log in page.

    -
    -
    -rhdh homepage -
    -
    Figure 8. RHDH Log in Page
    -
    -
    10. -
  10. -

    Click Enter in the Guest card to log in as a guest user. You will a warning message pop up with the text Failed to sign in as a guest using the auth backend. Do you want to fallback to the legacy guest token?. Click Yes to log in as a guest user. -You will configure RHDH to authenticate against GitHub and other identity providers in later chapters of this course.

    -
    -
    -rhdh guest user -
    -
    Figure 9. Log in as a guest user
    -
    -
    -

    You have now successfully installed Red Hat Developer Hub on your OpenShift cluster using the RHDH operator.

    -
    -
    11. -
-
-
-
-
-
-

RHDH PostgreSQL Database

-
-
- - - - - -
- - -
-

The default installation of RHDH (for both Helm Charts and Operator based installs) deploys a single PostgreSQL 15 database pod. This is a potential single point of failure and could prevent RHDH from being highly available.

-
-
-

You should follow the installation instructions and install the default single instance PostgreSQL to complete the install. You can then configure the RHDH container to integrate with an external PostgreSQL database instance using the instructions provided in the product documentation at Configuring an external PostgreSQL instance using the Helm Chart.

-
-
-
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/uninstall.html b/pr-preview/pr-13/devhub-admin/1/chapter1/uninstall.html deleted file mode 100644 index 28dbcef..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter1/uninstall.html +++ /dev/null @@ -1,243 +0,0 @@ - - - - - - Red Hat Developer Hub Uninstallation :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Red Hat Developer Hub Uninstallation

-
-
-
- - - - - -
- - -Before you uninstall RHDH, verify if you need to back up the data in the RHDH PostgreSQL database, plus any RHDH configuration stored in ConfigMaps and Secrets! -
-
-
-
-
-

Uninstalling the RHDH Helm Chart

-
-
-

You can uninstall RHDH using the OpenShift web console.

-
-
-
    -
  1. -

    Ensure that you are in the Developer perspective of the OpenShift console. Click on Helm to view the installed releases in the Helm Releases tab.

    -
    2. -
  2. -

    Expand the hamburger menu on the right of the rhdh release and click Delete Helm Release.

    -
    -
    -helm release delete -
    -
    Figure 1. Delete Helm Release
    -
    -
    3. -
  3. -

    Type the release name rhdh into the dialog that pops up and click Delete to delete the resources created by the helm chart.

    -
    4. -
-
-
-
-
-

Uninstalling the RHDH Helm Chart using the CLI

-
-
-

You can uninstall RHDH using the helm CLI.

-
-
-
    -
  1. -

    Log in to the OpenShift cluster as the cluster administrator. Ensure that you switch to the devhub project.

    -
    -
    -
    $ oc login -u admin https://api.cluster-<your_guid>.dynamic.redhatworkshops.io:6443
-$ oc project devhub
    -
    -
    -
    2. -
  2. -

    Run the following command to uninstall RHDH

    -
    -
    -
    $ helm uninstall rhdh
-release "rhdh" uninstalled
    -
    -
    -
    3. -
-
-
-
-
-

Uninstalling the RHDH Operator

-
-
-

To uninstall the RHDH operator, do the following:

-
-
-
    -
  1. -

    Switch to the Developer perspective, and click Topolgy. Click the hamburger menu option (three vertical dots) next to the Backstage instance (Blue badge marked 'B'), and then click Delete Backstage to delete the RHDH instance.

    -
    -
    -del rhdh op instance -
    -
    Figure 2. Delete RHDH instance
    -
    -
    2. -
  2. -

    Now, switch to the Administrator perspective, and then click Operators > Installed Operators. Select the project where you installed the operator (devhub), and expand the menu option against the Red Hat Developer Hub Operator. Click Uninstall Operator to remove the operator.

    -
    -
    -uninstall rhdh op -
    -
    Figure 3. Uninstall RHDH operator
    -
    -
    3. -
-
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter1/upgrade.html b/pr-preview/pr-13/devhub-admin/1/chapter1/upgrade.html deleted file mode 100644 index a34ac7f..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter1/upgrade.html +++ /dev/null @@ -1,261 +0,0 @@ - - - - - - Upgrading Red Hat Developer Hub :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Upgrading Red Hat Developer Hub

-
-
-
-

Upgrading RHDH depends on your install method that you selected.

-
-
- - - - - -
- - -Before you perform any updates to RHDH, ensure that you back up ALL the data in the RHDH PostreSQL database, plus any RHDH configuration stored in ConfigMaps and Secrets! -
-
-
-
-
-

Upgrading the RHDH Helm Chart

-
-
-

You can update RHDH using the OpenShift web console.

-
-
-
    -
  1. -

    Ensure that you are in the Developer perspective of the OpenShift console. Click on Helm to view the installed releases in the Helm Releases tab.

    -
    2. -
  2. -

    Expand the hamburger menu on the right of the rhdh release and click Upgrade.

    -
    -
    -helm release upgrade -
    -
    Figure 1. Upgrade Helm Release
    -
    -
    3. -
  3. -

    In the Upgrade Helm Release page, select the version of RHDH you want to upgrade to in the Chart version drop-down. This list shows the different helm chart versions of RHDH that have been publicly released.

    -
    -
    -select chart upgrade -
    -
    Figure 2. Select Upgrade Version
    -
    -
    4. -
  4. -

    After you have selected a version for upgrade, click Upgrade. Wait for 10-15 minutes while the resources in the older versions are deleted, and newer versions of the RHDH pod(s) are launched.

    -
    5. -
  5. -

    Close all open RHDH web pages, and log in again to verify that the upgrade was successful.

    -
    6. -
-
-
-
-
-

Upgrading the RHDH Helm Chart using the CLI

-
-
-

You can update RHDH using the helm CLI.

-
-
-
    -
  1. -

    Log in to the OpenShift cluster as the cluster administrator. Ensure that you switch to the devhub project.

    -
    -
    -
    $ oc login -u admin https://api.cluster-<your_guid>.dynamic.redhatworkshops.io:6443
-$ oc project devhub
    -
    -
    -
    2. -
  2. -

    Assuming there is a new version of the RHDH helm chart (for example, 1.2.1), run the following command to upgrade RHDH.

    -
    -
    -
    $ helm upgrade -i rhdh \
-  openshift-helm-charts/redhat-developer-hub --version 1.2.1
-
-Release "rhdh" has been upgraded. Happy Helming!
-NAME: rhdh
-LAST DEPLOYED: Fri Jun 28 18:06:47 2024
-NAMESPACE: devhub
-STATUS: deployed
-REVISION: 2
    -
    -
    -
    -

    You can also supply extra values to the chart by creating a new-values.yml file on your workstation with values that override the attributes in the installed chart, or add new attributes.

    -
    -
    -
    -
    $ helm upgrade -i rhdh -f new-values.yml \
-  openshift-helm-charts/redhat-developer-hub --version 1.2.1
    -
    -
    -
    3. -
-
-
-
-
-

Upgrading the RHDH Operator using the OpenShift Web Console

-
-
-

The default setting during operator install is set to Automatic mode. In this mode, new versions of the operator are automatically downloaded and applied. If you chose the Manual mode, a cluster administrator needs to manually approve each upgrade. In such cases, switch to the Administrator perspective, and then click on Operators > Installed Operators to view the updates for the RHDH operator.

-
-
-
-op upgrade -
-
Figure 3. Operator Updates
-
-
-

Click Upgrade Available for the RHDH operator, and then click Preview InstallPlan. Click Approve to approve the update.

-
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/2-gh-auth.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/2-gh-auth.png deleted file mode 100644 index 7cfcaf9..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/2-gh-auth.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/3-gh-auth.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/3-gh-auth.png deleted file mode 100644 index 1480750..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/3-gh-auth.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/4-gh-auth.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/4-gh-auth.png deleted file mode 100644 index d7f2215..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/4-gh-auth.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/404-error-rbac.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/404-error-rbac.png deleted file mode 100644 index a552ca5..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/404-error-rbac.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/8-gh-auth.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/8-gh-auth.png deleted file mode 100644 index 33c60ab..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/8-gh-auth.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/9-gh-auth.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/9-gh-auth.png deleted file mode 100644 index 6cc4c00..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/9-gh-auth.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/container-vol-mounts.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/container-vol-mounts.png deleted file mode 100644 index f162d7f..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/container-vol-mounts.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/container-volumes.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/container-volumes.png deleted file mode 100644 index 4811b73..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/container-volumes.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/create-rhdh-secrets.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/create-rhdh-secrets.png deleted file mode 100644 index 218e1fc..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/create-rhdh-secrets.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/edit-backstage-cr.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/edit-backstage-cr.png deleted file mode 100644 index 955787c..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/edit-backstage-cr.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/gh-identity-visible.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/gh-identity-visible.png deleted file mode 100644 index f517f50..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/gh-identity-visible.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/guest-sign-out.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/guest-sign-out.png deleted file mode 100644 index 6999521..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/guest-sign-out.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/helm-resources.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/helm-resources.png deleted file mode 100644 index 8b108a4..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/helm-resources.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-admin-ui.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-admin-ui.png deleted file mode 100644 index b5cc986..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-admin-ui.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-allow-catalog-create.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-allow-catalog-create.png deleted file mode 100644 index ff4ef41..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-allow-catalog-create.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-configmap.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-configmap.png deleted file mode 100644 index fb888ca..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-configmap.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-confirm-policy-change.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-confirm-policy-change.png deleted file mode 100644 index 8b98efb..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-confirm-policy-change.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-policy-details.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-policy-details.png deleted file mode 100644 index a4059b4..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-policy-details.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-token.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-token.png deleted file mode 100644 index 9afa27b..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rbac-token.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/restart-rollout.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/restart-rollout.png deleted file mode 100644 index 420c2de..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/restart-rollout.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rhdh-op-resources.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rhdh-op-resources.png deleted file mode 100644 index a476456..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/rhdh-op-resources.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/sign-in-github.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/sign-in-github.png deleted file mode 100644 index e2704bc..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/sign-in-github.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-gh-profile.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-gh-profile.png deleted file mode 100644 index 41ead84..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-gh-profile.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-kind-groups.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-kind-groups.png deleted file mode 100644 index 7d833a4..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-kind-groups.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-kind-users.png b/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-kind-users.png deleted file mode 100644 index 8a0ccd2..0000000 Binary files a/pr-preview/pr-13/devhub-admin/1/chapter2/_images/view-kind-users.png and /dev/null differ diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/basic-config.html b/pr-preview/pr-13/devhub-admin/1/chapter2/basic-config.html deleted file mode 100644 index adde100..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter2/basic-config.html +++ /dev/null @@ -1,460 +0,0 @@ - - - - - - Basics of Red Hat Developer Hub Configuration :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Basics of Red Hat Developer Hub Configuration

-
-
-
-

Recall that RHDH is deployed as an immutable container on OpenShift. Upgrading RHDH to new versions deploys a new container, so the configuration is maintained outside the container as YAML files, which are parsed at container start up and the state persisted to the PostgreSQL database used by RHDH.

-
-
-

RHDH uses a number of different YAML files for configuration. Various runtime variables, plugin configuration, and other behaviors can be controlled using these YAML configuration files.

-
-
- - - - - -
- - -The sections in this chapter assume you have installed RHDH using the operator. If you used a Helm chart for installation, the configuration should more or less work with minimal changes. Consult the product documentation for details. -
-
-
-
-
-

Exploring the default RHDH Configuration

-
-
-

Let us briefly inspect the OpenShift resources created by the RHDH operator after installation.

-
-
-

Log in as the OpenShift cluster administrator user in the web console and switch to the Developer perspective. -Click on Topology in the left sidebar, and then expand the hamburger menu (three vertical dots) next to the rhdh Backstage custom resource (CR) to select the Edit Backstage option

-
-
-
-edit backstage cr -
-
Figure 1. Edit Backstage CR
-
-
-

In the Backstage details page, click the Resources tab to view the resources created by the operator installation.

-
-
-
-rhdh op resources -
-
Figure 2. Resources created by the operator
-
-
-

The two ConfigMap resources, backstage-dynamic-plugins-rhdh and backstage-appconfig-rhdh are used to configure the dynamic plugins, and the overall configuration of RHDH respectively.

-
-
-

The default.app-config.yaml configuration stored in the backstage-appconfig-rhdh ConfigMap is as follows:

-
-
-
-
data:
-  default.app-config.yaml: |
-    backend:
-      auth:
-        keys:
-          # This is a default value, which you should change by providing your own app-config
-          - secret: "pl4s3Ch4ng3M3"
-
-
-
- - - - - -
- - -This default.app-config.yaml section should not be edited directly to avoid problems during operator upgrades. Instead you must define your own custom app-config-rhdh.yaml configuration file as a separate ConfigMap resource, and override the default configuration values. -
-
-
-
-
-

Application Configuration Files (app-config-*.yaml)

-
-
-

Recall that an instance of RHDH is called an "App" (short form of Application), and the instance is configured using YAML files. RHDH runs as a container on OpenShift, so this and other configuration files for RHDH should be created as OpenShift ConfigMaps and mounted inside the container.

-
-
- - - - - -
- - -
-

Do NOT hard code sensitive and confidential values in the app-config.yaml files! Instead, use environment variable placeholders. You can then store plain text values using ConfigMaps and confidential values like passwords, API keys, encrypted tokens and other sensitive information using Secrets.

-
-
-
-
-

The configuration is validated using JSON Schema definitions. You can enable or disable components and plugins, and configure them using these app-config-*.yaml files. -The configuration is shared between the frontend and backend. Values that are common between the two needs to be defined only once, for example, the backend.baseUrl, which defines the root URL of the backend REST API.

-
-
-

Configuration is stored in YAML files where the defaults are app-config.yaml and app-config.local.yaml for locally overriding configuration variables from the default configuration file. Other sets of files can by loaded by passing --config flags.

-
-
-

It is possible to have multiple configuration files, to support different environments (Development, QA, Staging, Production, and more), and also to override configuration that is for specific components and plugins. The configuration files to load are selected using a --config flag, and it is possible to load any number of files.

-
-
-

If no --config flags are specified, the default behavior is to load app-config.yaml. Note that if any --config flags are used, the default app-config.yaml file is NOT loaded. To include it, you need to explicitly pass it as --config arguments, for example:

-
-
-

The RHDH container image uses an entrypoint defined as follows for starting the backend container:

-
-
-
-
node packages/backend
-  --config app-config.yaml \
-  --config app-config.example.yaml \
-  --config app-config.example.production.yaml
-
-
-
-

It is also possible to supply configuration through environment variables, for example, consider the YAML configuration snippet like below:

-
-
-
-
app:
-  baseUrl: https://${HOST}
-
-
-
-

You can override the value of baseUrl by passing an environment variable named APP_CONFIG_app_baseUrl=https://staging.example.com to the RHDH container. -The environment variable name must be prefixed with APP_CONFIG and the nested YAML attributes separated with underscore("_") symbol.

-
-
- - - - - -
- - -This approach should be used sparingly, usually just for temporary overrides during development. -
-
-
-
-
-

Configuration File Precedence

-
-
-

Configuration methods have different priority, higher priority methods replace values from configurations with lower priority. -The priority of the configurations is determined by the following rules, in order:

-
-
-
    -
  1. -

    Configuration from the APP_CONFIG_ environment variables has the highest priority, followed by files.

    -
    2. -
  2. -

    Files loaded with --config flags are ordered by priority, where the last flag has the highest priority.

    -
    3. -
  3. -

    If no --config flags are provided, app-config.local.yaml has higher priority than app-config.yaml.

    -
    4. -
-
-
-
-
-

Lab: Adding a Custom app-config YAML File

-
-
-

It is a good practice to override the default.app-config.yaml file using your own custom configuration file embedded inside a ConfigMap, and passing it as an argument using --config flags. At runtime, the values from the default configuration are merged with the values from your custom configuration file.

-
-
-

To create the custom configuration file, do the following:

-
-
-
    -
  1. -

    Create a new ConfigMap named app-config-rhdh resource in the same OpenShift project where you installed RHDH (devhub). Click on ConfigMap > Create ConfigMap > YAML view and paste the following YAML snippet.

    -
    -
    -
    kind: ConfigMap
-apiVersion: v1
-metadata:
-  name: app-config-rhdh
-data:
-  "app-config-rhdh.yaml": |
-    app:
-      title: Red Hat Developer Hub
-      baseUrl: https://backstage-rhdh-devhub.apps.cluster-<guid>.dynamic.redhatworkshops.io (1)
-    backend:
-      auth:
-        keys:
-          - secret: "${BACKEND_SECRET}" (2)
-      baseUrl: https://backstage-rhdh-devhub.apps.cluster-<guid>.dynamic.redhatworkshops.io (1)
-      cors:
-        origin: https://backstage-rhdh-devhub.apps.cluster-<guid>.dynamic.redhatworkshops.io (1)
    -
    -
    -
    - - - - - - - - - -
    1The RHDH URL. Replace guid with your unique guid from RHDP
    2A secret to define the mandatory RHDH backend authentication key
    -
    -
    2. -
  2. -

    Click Create to create the ConfigMap.

    -
    3. -
  3. -

    The custom application configuration file contains a sensitive environment variable, named BACKEND_SECRET. This variable contains a mandatory backend authentication key that Developer Hub uses to reference an environment variable defined in an OpenShift Container Platform secret. You must create a secret, named secrets-rhdh, and reference it in the Developer Hub CR. Click Secrets > Create Key/value secret.

    -
    4. -
  4. -

    In the Create key/value secret page, enter secrets-rhdh in the Secret name field, enter BACKEND_SECRET in the Key field. For the Value field, open a new command line terminal and generate a base64 encoded string using the following command:

    -
    -
    -
    $ node -p 'require("crypto").randomBytes(24).toString("base64")'
    -
    -
    -
    5. -
  5. -

    Copy the randomly generated string to the Value field, and then click Create to create the secret.

    -
    -
    -create rhdh secrets -
    -
    Figure 3. Create a new secret
    -
    -
    6. -
  6. -

    Now that you have created your own custom configuration file with an embedded secret, you need to reference the new custom configuration file in the backstage custom resource (CR) and restart the RHDH container for the changes to take effect. Click on Topology in the left sidebar, and then expand the hamburger menu (three vertical dots) next to the rhdh Backstage custom resource (CR) to select the Edit Backstage option

    -
    -
    -edit backstage cr -
    -
    Figure 4. Edit Backstage CR
    -
    -
    7. -
  7. -

    Reference the app-config-rhdh ConfigMap and the rhdh-secrets secret in the CR:

    -
    -
    -
    apiVersion: rhdh.redhat.com/v1alpha1
-kind: Backstage
-metadata:
-...
-spec:
-  application:
-    appConfig:
-      mountPath: /opt/app-root/src
-      configMaps:
-         - name: app-config-rhdh
-    extraEnvs:
-      secrets:
-         - name: secrets-rhdh
-    extraFiles:
-      mountPath: /opt/app-root/src
-    replicas: 1
-    route:
-      enabled: true
-  database:
-    enableLocalDb: true
-...
    -
    -
    -
    8. -
  8. -

    Click Save to save the changes to the Backstage CR.

    -
    9. -
  9. -

    Switch to the Topology view, and expand the menu next to the backstage-rhdh pod. Click Restart rollout to restart the RHDH pod.

    -
    -
    -restart rollout -
    -
    Figure 5. Restart RHDH pod to re-read configuration value changes
    -
    -
    10. -
-
-
-

Wait for the RHDH pod to restart (It may take a few minutes). Ensure that the pod is restarted without any errors. To troubleshoot failed startup, click on the backstage-rhdh pod, and then click the Resources tab. Click View logs to view the pod logs. Ensure that you correctly indent the CR yaml file when referencing the secret and ConfigMap. Incorrect indentation may cause the pod restart to fail.

-
-
-

Throughout the rest of the course, you will edit the app-config-rhdh ConfigMap to configure and enable plugins for RHDH.

-
-
-

Whenever you change the configuration in the app-config-rhdh ConfigMap, or create/edit any new secrets, you can force RHDH to re-read the configuration by clicking on the RHDH pod in the Topology page and then selecting Restart rollout.

-
-
-

You can also scale down the RHDH pod to zero (0), and then scale it up back to one or more to reload the configuration.

-
-
-
-
-

References

-
-
- -
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/git-auth.html b/pr-preview/pr-13/devhub-admin/1/chapter2/git-auth.html deleted file mode 100644 index 0204fbf..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter2/git-auth.html +++ /dev/null @@ -1,673 +0,0 @@ - - - - - - Configuring Authentication using GitHub :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Configuring Authentication using GitHub

-
-
-
-

The authentication system in RHDH is handled by Authentication Providers. RHDH uses the providers to access identity and user information, which can be used to delegate access rights to various plugins and services in RHDH. You can configure RHDH to have multiple authentication providers, with only ONE provider being actively used at any given time for logging in users.

-
-
-

RHDH supports many common authentication providers by default like GitHub, GitLab, Auth0, Okta, and more. Consult the references section at the bottom of this page for the full list.

-
-
- - - - - -
- - -Authentication providers are responsible only for authenticating the identity of the user, and passing on this information to RHDH. Authorization, that is, what actions an authenticated identity can perform in RHDH are handled by a different component of RHDH called Role Based Access Control (RBAC) using Permission Policies. RBAC is covered in a separate section of this course. -
-
-
-

Consider the scenario where your organization’s developers use GitHub to manage source code. You would ideally like developers to use their GitHub credentials to log in to RHDH, and also import team and user information from GitHub. Very often, developers are added to a GitHub Organization to manage groups of developers. The following exercise configures RHDH to use GitHub for authentication, and imports the GitHub organization member and team details into the RHDH database.

-
-
-

RHDH also ingtegrates with GitHub to offer various other features. There are separate plugins to interact with GitHub repositories and visualize issues, releases, deployments and other GitHub features. You can also fetch and synchronize team information from GitHub Organizations and visualize them as Groups and Users in RHDH.

-
-
-
-
-

Lab: Configuring Integration and Authentication with GitHub

-
-
-

Pre-requisites

-
-
    -
  • -

    A GitHub account

    -
    • -
  • -

    Administrator rights to a GitHub Organization (Create a new Github Org if it does not exist)

    -
    -
      -
    • -

      Create one or more teams within your GitHub Organization

      -
      • -
    • -

      Invite one or more users to your GitHub Organization

      -
      • -
    -
    -
    • -
  • -

    OpenShift cluster administrator access

    -
    • -
  • -

    Ability to create GitHub Apps on GitHub

    -
    • -
-
-
-

Configuring GitHub for RHDH authentication involves two major steps:

-
-
-
    -
  • -

    Create a new GitHub App for your GitHub organization

    -
    • -
  • -

    Edit the app-config-rhdh ConfigMap and configure RHDH to use the GitHub App for authentication. To prevent storing credentials in plain text in the ConfigMap, you will embed the credentials for GitHub in a secret, and then refer the secret keys in the app-config-rhdh ConfigMap.

    -
    • -
-
-
-
-

Create a new GitHub App

-
-
    -
  1. -

    Navigate to https://github.com/organizations/<YOUR_ORGANIZATION>/settings/apps, and then click New GitHub App.

    -
    2. -
  2. -

    In the Register new GitHub App page, fill out the following details:

    -
    - -
    -
    3. -
  3. -

    Verify your form entries, and when you are satisfied click Create GitHub App.

    -
    4. -
  4. -

    You will be shown your App ID and a client ID. Make note of these values for the next step.

    -
    5. -
  5. -

    Click Generate a new client secret. Copy the generated secret for the next steps.

    -
    -
    -2 gh auth -
    -
    Figure 1. Generate Client Secret
    -
    -
    6. -
  6. -

    Scroll down to the Private Keys section and click Generate a private key. The private key will be downloaded. Copy the generated private key certificate (it is in PEM format) to a safe location.

    -
    7. -
  7. -

    In the left sidebar menu of the generated app, select Install App, and then click Install.

    -
    8. -
  8. -

    Select All Repositories for Repository access and then click Install.

    -
    -
    -8 gh auth -
    -
    Figure 2. Install GitHub App
    -
    -
    9. -
-
-
-
-

Create a Secret to Store GitHub App Credentials

-
-

Rather than storing the GitHub App credentials in plain text directly in the app-config-rhdh ConfigMap, you will create a secret to store the credentials. You will then refer to the credentials as environment variables in the ConfigMap.

-
-
-
    -
  1. -

    Create a file named env.sh with the following environment variables and replace the values with the GitHub App details you created in the previous step. Replace the GITHUB_APP_PRIVATE_KEY_FILE with your private key file that you downloaded from GitHub. Change guid to your unique RHDP GUID.

    -
    -
    -
    export OPENSHIFT_CLUSTER_INFO=$(oc cluster-info | head -n 1 | sed 's/^.https...api//' | sed 's/.6443.$//')
-export K8S_CLUSTER_API=$(oc cluster-info | head -n 1 |  sed 's/^.*https/https/')
-
-export GITHUB_HOST_DOMAIN=https://github.com
-export GITHUB_ORGANIZATION='Your Org Name'
-export GITHUB_ORG_URL=$GITHUB_HOST_DOMAIN/$GITHUB_ORGANIZATION
-
-export GITHUB_APP_ID='Your App ID'
-export GITHUB_APP_CLIENT_ID='Your client ID'
-export GITHUB_APP_CLIENT_SECRET='Your client secret'i
-export GITHUB_APP_PRIVATE_KEY_FILE="$(< rhdh-app-<guid>.2024-01-17.private-key.pem)"
-
-export GITHUB_APP_WEBHOOK_URL='https://rhdh-developer-hub-devhub.apps.cluster-<guid>.dynamic.redhatworkshops.io'
-export GITHUB_APP_WEBHOOK_SECRET='Your webhook secret'
    -
    -
    -
    2. -
  2. -

    Log in to the OpenShift cluster as the admin user using the oc CLI.

    -
    3. -
  3. -

    Switch to the devhub namespace where you installed RHDH.

    -
    4. -
  4. -

    Source the env.sh file to export the environment variables:

    -
    -
    -
    $ source env.sh
    -
    -
    -
    5. -
  5. -

    You created a secret named rhdh-secrets to store the backend API token after installation. You need to add more keys to this secret. Execute the following command to add keys related to GitHub authentication:

    -
    -
    -
    $ oc set data secret/rhdh-secrets -n devhub \
-  GITHUB_HOST_DOMAIN=$GITHUB_HOST_DOMAIN \
-  GITHUB_ORGANIZATION=$GITHUB_ORGANIZATION \
-  GITHUB_ORG_URL=$GITHUB_ORG_URL \
-  GITHUB_APP_ID=$GITHUB_APP_ID \
-  GITHUB_APP_CLIENT_ID=$GITHUB_APP_CLIENT_ID  \
-  GITHUB_APP_CLIENT_SECRET=$GITHUB_APP_CLIENT_SECRET \
-  GITHUB_APP_PRIVATE_KEY_FILE=$GITHUB_APP_PRIVATE_KEY_FILE \
-  GITHUB_APP_WEBHOOK_URL=$GITHUB_APP_WEBHOOK_URL \
-  GITHUB_APP_WEBHOOK_SECRET=$GITHUB_APP_WEBHOOK_SECRET
    -
    -
    -
    6. -
-
-
-
-

Configure RHDH for GitHub Authentication

-
-
    -
  1. -

    Log in to the OpenShift web console as the admin user and switch to the Developer Perspective.

    -
    2. -
  2. -

    Click ConfigMaps and select the app-config-rhdh. Toggle the YAML tab to switch to YAML editing mode.

    -
    3. -
  3. -

    Add the following YAML configuration at the same indentation level as the app attribute. Note the reference to environment variables instead of hard coded credentials:

    -
    -
    -
    ...
-app-config-rhdh.yaml: |
-    app:
-      title: Red Hat Developer Hub
-      baseUrl: https://backstage-rhdh-devhub.apps.cluster-jf4k8.dynamic.redhatworkshops.io
-    backend:
-      auth:
-        keys:
-          - secret: "${BACKEND_SECRET}"
-      baseUrl: https://backstage-rhdh-devhub.apps.cluster-jf4k8.dynamic.redhatworkshops.io
-      cors:
-        origin: https://backstage-rhdh-devhub.apps.cluster-jf4k8.dynamic.redhatworkshops.io
-    auth:
-      environment: production (1)
-      providers:
-        github: (2)
-          production:
-            clientId: ${GITHUB_APP_CLIENT_ID}
-            clientSecret: ${GITHUB_APP_CLIENT_SECRET}
-    integrations: (3)
-      github:
-        - host: github.com
-          apps:
-            - appId: ${GITHUB_APP_ID}
-              clientId: ${GITHUB_APP_CLIENT_ID}
-              clientSecret: ${GITHUB_APP_CLIENT_SECRET}
-              webhookUrl: ${GITHUB_APP_WEBHOOK_URL}
-              webhookSecret: ${GITHUB_APP_WEBHOOK_SECRET}
-              privateKey: |
-                ${GITHUB_APP_PRIVATE_KEY_FILE}
-    signInPage: github (4)
    -
    -
    -
    - - - - - - - - - - - - - - - - - -
    1Marking the environment as production hides the Guest login in the RHDH home page
    2Add configuration for the GitHub auth provider
    3Generic integration plugin for GitHub. This is used by various GitHub plugins to integrate with the GitHub API
    4Enable log in using GitHub credentials in the RHDH front end
    -
    -
    4. -
-
-
-
-

Configure RHDH to Import Users and Groups in a GitHub Organization

-
-
    -
  1. -

    To enable GitHub Organization member discovery, add the following YAML configuration at the same indentation level as the app attribute, and below the signInPage attribute:

    -
    -
    -
    catalog:
-  providers:
-    github: (1)
-      providerId:
-        organization: "${GITHUB_ORGANIZATION}"
-        schedule: (2)
-          frequency:
-            minutes: 30
-          initialDelay:
-            seconds: 15
-          timeout:
-            minutes: 15
-    githubOrg:
-      githubUrl: "${GITHUB_URL}"
-      orgs: [ "${GITHUB_ORGANIZATION}" ]
-      schedule: (2)
-        frequency:
-          minutes: 30
-        initialDelay:
-          seconds: 15
-        timeout:
-          minutes: 15
    -
    -
    -
    - - - - - - - - - -
    1Configuration for GitHub plugin to periodically scan GitHub repositories and import into the RHDH catalog
    2Scheduled polling of Git repositories and Organization
    -
    -
    -

    Click Save.

    -
    -
    2. -
-
-
-
-

Enable the GitHub Plugins

-
-

The final step is to enable the GitHub and GitHub Organization discovery dynamic plugins.

-
-
-
    -
  1. -

    You need to create a new ConfigMap named dynamic-plugins-rhdh-local and enable the GitHub related plugins. You will enable other plugins in the upcoming courses to enable other RHDH functionality. Create a new ConfigMap using the following YAML snippet:

    -
    -
    -
    kind: ConfigMap
-apiVersion: v1
-metadata:
-  name: dynamic-plugins-rhdh-local
-  namespace: devhub
-data:
-  dynamic-plugins.yaml: |
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins: (1)
-      - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-dynamic'
-        disabled: false
-      - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-org-dynamic'
-        disabled: false
    -
    -
    -
    - - - - - -
    1Plugin definition and enable or disable on a per-plugin basis
    -
    -
    2. -
  2. -

    Edit the Backstage custom resource (CR) by clicking Topology and then expanding the Backstage instance menu (Blue badge marked 'B') and then selecting Edit Backstage. Add a new attribute named dynamicPluginsConfigMapName under spec.application as follows and reference the new ConfigMap for the dynamic plugin configuration.

    -
    -
    -
    ...
-spec:
-  application:
-    appConfig:
-      configMaps:
-        - name: app-config-rhdh
-      mountPath: /opt/app-root/src
-    dynamicPluginsConfigMapName: dynamic-plugins-rhdh-local
-    extraEnvs:
-      secrets:
-        - name: rhdh-secrets
-...
    -
    -
    -
    -

    Click Save when done.

    -
    -
    3. -
  3. -

    Restart the RHDH pod by selecting the Restart rollout option in the Topology view. Wait for a few minutes and verify that the pod is restarted without any errors. If there are errors, check the pod logs for missing attributes in the YAML files, or wrong indentation.

    -
    4. -
-
-
-
-

Verify User Sign In

-
-
    -
  1. -

    If you are signed in as a Guest RHDH user, then sign out by selecting the Sign Out (expand the …​ next to the Profile card) in the Settings > Profile page.

    -
    -
    -guest sign out -
    -
    Figure 3. Guest Sign out
    -
    -
    2. -
  2. -

    Sign in using GitHub sign-in method in the RHDH home page

    -
    -
    -sign in github -
    -
    Figure 4. GitHub Sign in
    -
    -
    3. -
  3. -

    You will be re-directed to a GitHub prompt asking you to sign in using your GitHub credentials. Once you are signed in, you will be asked to allow access to your GitHub profile data.

    -
    -
    -4 gh auth -
    -
    Figure 5. GitHub Allow Access Prompt
    -
    -
    4. -
  4. -

    After you are signed in, navigate to the Settings page. Notice that GitHub has authenticated the user and provided identity information to RHDH.

    -
    -
    -gh identity visible -
    -
    Figure 6. GitHub Identity in Settings Page
    -
    -
    5. -
  5. -

    Click on the logged in User Entity in the Settings page to view the detail imported from GitHub. Notice that the plugin has fetched the details of the logged in user from GitHub.

    -
    -
    -view gh profile -
    -
    Figure 7. View Profile Data
    -
    -
    6. -
  6. -

    Click on the RHDH Catalog in the sidebar. Select the Kind drop-down, and note that two new entities called User and Group are now visible. You may have to wait for a few minutes while the data is fetched from GitHub.

    -
    7. -
  7. -

    Select Group in the Kind drop-down to view the teams (mapped into RHDH Groups) imported from the GitHub organization. If you have not created teams in GitHub, then do so now before proceeding. You may have to wait for a few minutes while the data is fetched from GitHub.

    -
    -
    -view kind groups -
    -
    Figure 8. View Groups (Teams) from GitHub
    -
    -
    8. -
  8. -

    Select User in the Kind drop-down to view the users imported from the GitHub organization. If you have not invited users to your organization in GitHub, then do so now before proceeding. You may have to wait for a few minutes while the data is fetched from GitHub.

    -
    -
    -view kind users -
    -
    Figure 9. View Users Imported from GitHub
    -
    -
    9. -
-
-
-
-

Troubleshooting Tips

-
-

To troubleshoot issues with the RHDH container, enable debug logging as follows to get verbose logging in container logs:

-
-
-
-
$ oc set env deployment rhdh-developer-hub LOG_LEVEL=debug -n devhub
-
-
-
-

Once debugging is complete switch log level back to info.

-
-
-
-
-
-

References

-
-
- -
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/index.html b/pr-preview/pr-13/devhub-admin/1/chapter2/index.html deleted file mode 100644 index 573a494..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter2/index.html +++ /dev/null @@ -1,158 +0,0 @@ - - - - - - Basic Configuration :: Red Hat Developer Hub Administration - - - - - - - -
- -
-
- -
-
- -
- -
-

Basic Configuration

-
-

In this chapter, you will learn how to perform basic configuration of your Red Hat Developer Hub (RHDH) instance, and configure authentication and authorization for users.

-
-
-

Goals:

-
-
-
    -
  • -

    Describe the configuration mechanism in RHDH

    -
    • -
  • -

    Configure authentication using GitHub

    -
    • -
  • -

    Configure authorization using Role Based Access Control (RBAC)

    -
    • -
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/chapter2/rbac.html b/pr-preview/pr-13/devhub-admin/1/chapter2/rbac.html deleted file mode 100644 index b832bcb..0000000 --- a/pr-preview/pr-13/devhub-admin/1/chapter2/rbac.html +++ /dev/null @@ -1,501 +0,0 @@ - - - - - - Role Based Access Control (RBAC) :: Red Hat Developer Hub Administration - - - - - - -
- -
-
- -
-
- -
- -
-

Role Based Access Control (RBAC)

-
-
-
-

In the previous section, you learnt how to authenticate users (that is, who they are). In this section you will learn how to authorize users to perform actions in RHDH (that is, what they can do in RHDH).

-
-
-

Role-Based Access Control (RBAC) is a security concept that controls access to resources in a system, and specifies a mapping between users of the system, and the actions they can perform on resources in the system. You define roles with specific permissions , and then assign the roles to users.

-
-
-

RBAC on RHDH is built on top of the Permissions framework in Backstage, which defines RBAC policies in code. Rather than define policies in code, the RHDH RBAC feature allows you to define policies in a declarative fashion using a simple CSV based format.

-
-
-

To apply RBAC in RHDH, you need to do two things:

-
-
-
    -
  1. -

    Configure an authenticated user as a Policy Administrator

    -
    2. -
  2. -

    Configure policies in a CSV file and import it into RHDH

    -
    3. -
-
-
-
-
-

Declarative Role Based Access Control

-
-
-

RBAC in RHDH is configured using a CSV file that follows the casbin (https://casbin.org) format, a popular declarative domain specific language (DSL) for access control.

-
-
-

A RBAC policy CSV consists of a number of lines of declarations. A policy declaration consists of lines in the following format:

-
-
-
-
type, role_name, resource, action, permission
-
-
-
-

where,

-
-
-
    -
  • -

    type = should be a single letter - p for policy type, or g for role assignments to users

    -
    • -
  • -

    role_name = A custom role name defined by you, for example admins, users, viewers

    -
    • -
  • -

    resource = features in RHDH, for example catalog-entity, policy-entity, scaffolder-template, and more

    -
    • -
  • -

    action = create, update, delete, or read

    -
    • -
  • -

    permission = allow or deny

    -
    • -
-
-
-

Consult the references section at the bottom of this page for the full list of resource types in RHDH.

-
-
-

Consider the following policy snippet:

-
-
-
-
p, role:default/myrole, catalog-entity, read, allow
-p, role:default/myrole, catalog.entity.delete, delete, deny
-g, user:default/myuser, role:default/myrole
-
-
-
-

It defines a custom role named myrole that permits read only access to the RHDH catalog, but denies deletes. The last line in the policy CSV file assigns the myuser user the myrole role. The myuser user should be a valid identity that is authenticated by one of the identity providers supported by RHDH.

-
-
-
-
-

Lab: Configure Policy Administrators

-
-
- - - - - -
- - -The main reason to declare policy administrators is to allow a certain limited number of authenticated users to invoke the RBAC REST API. The actual policies are defined in a separate CSV file and referenced in the app-config-rhdh ConfigMap. This can be done by OpenShift platform or cluster administrators who have access to the namespace where RHDH is running. -
-
-
-
    -
  1. -

    To declare users as policy administrators, add the following permission attribute to the app-config-rhdh ConfigMap (At the same indentation level as the app and below the catalog attribute). Ensure that you added a valid authenticated user for the admin.users attribute:

    -
    -
    -
    catalog:
-      providers:
-        github:
-          ...
-        githubOrg:
-          ...
-permission:
-      enabled: true
-      rbac:
-        admin:
-          users:
-            - name: user:/default/rsriniva
    -
    -
    -
    2. -
  2. -

    The RBAC plugin is disabled by default. Enable it by adding it to the list of dynamic plugins in the ConfigMap dynamic-plugins-rhdh-local.

    -
    -
    -
    ...
-data:
-  dynamic-plugins.yaml: |
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-dynamic'
-        disabled: false
-      - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-org-dynamic'
-        disabled: false
-      - package: './dynamic-plugins/dist/janus-idp-backstage-plugin-rbac'
-        disabled: false
    -
    -
    -
    3. -
  3. -

    Restart rollout of the RHDH pod from the Topology view.

    -
    4. -
  4. -

    Sign out from the existing RHDH session and log in again using the GitHub ID of the declared policy administrator.

    -
    5. -
  5. -

    Navigate to the Catalog page in RHDH. Note that the Create button is not visible. You are not allowed to create new components.

    -
    6. -
  6. -

    Next, try navigating to the API page. The Register button is not visible. With RBAC enabled, most features are disabled by default. You need to explicitly enable permissions to resources in RHDH.

    -
    7. -
-
-
-
-
-

Lab: RBAC Administration UI

-
-
-

To selectively allow RHDH features, you need to declare roles with allowed policies, and then assign these roles to users or groups. Previous versions of RHDH allowed you to do this using CSV files stored in ConfigMaps. Recent versions of RHDH have introduced a convienient web based UI to manage policies.

-
-
-

This section covers the RBAC Admin UI. Consult the product documentation for the process to manually specify policies using CSV files.

-
-
- - - - - -
- - -It is recommended to keep the RBAC system disabled when trying out features and functionality of RHDH like Software Templates, plugins, Search, and more. Turn it back on only if you know what you are doing, and you fully understand the impact of policies. -
-
-
-
    -
  1. -

    After you have enabled the RBAC dynamic plugin and add users to the rbac.admin.users list in the app-config-rhdh ConfigMap, log in to RHDH and then click Administration in the bottom of the left sidebar.

    -
    2. -
  2. -

    Notice that a new tab called RBAC is now enabled. There is a single role named rbac_admin declared with the users you declared in the rbac.admin.users list assigned to this role.

    -
    -
    -rbac admin ui -
    -
    Figure 1. RBAC Admin UI
    -
    -
    3. -
  3. -

    Click on the role:default/rbac_admin link. The policy details page lists the users assigned to this role in the left column, and the list of permitted policies on the right.

    -
    -
    -rbac policy details -
    -
    Figure 2. RBAC Policy Mapping
    -
    -
    -

    This user is allowed to create, edit, update and delete RBAC policies and view catalog items. With RBAC enabled, you need to explicitly allow users to create catalog items.

    -
    -
    4. -
  4. -

    Switch back the RBAC Administration page. Click Create to add a new policy.

    -
    5. -
  5. -

    In the Create Role screen, enter allow-catalog-create-policy as the policy name, and enter a brief description. Click Next.

    -
    6. -
  6. -

    In the Add users and groups screen, select users and groups that should be assigned to this role and click Next.

    -
    7. -
  7. -

    In the Add permission policies screen, select catalog in the Plugin field, and catalog.entity.create in the Resource type field. Ensure Create is selected in the actions and click Next.

    -
    8. -
  8. -

    Review your choices and click Create to create the policy.

    -
    -
    -rbac allow catalog create -
    -
    Figure 3. RBAC Policy to allow creation of catalog items
    -
    -
    9. -
  9. -

    You should get a confirmation message that the policy creation was successful. Log out and log in as the user to whom you assigned the policy. Navigate to the Catalog page. Verify that a Create button is now visible. Similarly, click APIs and verify that you can see a Register Existing API button. This user is now allowed to create catalog items. You can assign permissions to delete and update catalog items in a similar manner using the RBAC Admin UI.

    -
    10. -
-
-
-
-
-

RBAC REST API

-
-
-

RHDH provides an RBAC REST API that you can use to manage the permissions and roles programmatically. This API can be used to automate the maintenance of RHDH permission policies and roles.

-
-
-

You can perform the following actions with the REST API:

-
-
-
    -
  • -

    Retrieve information about all permission policies or specific permission policies, or roles

    -
    • -
  • -

    Create, update, or delete a permission policy or a role

    -
    • -
  • -

    Retrieve permission policy information about static plugins

    -
    • -
-
-
- - - - - -
- - -If RBAC is enabled, you may need to permit actions on the policy.entity resource for read, create and update to view and change policies using the REST API. Recall that the default policy is to deny, so you will see HTTP 401 or 403 errors if you make REST calls without policy changes. -
-
-
-

Detailed coverage of the REST API is beyond the scope of this course. Consult the references section for more details.

-
-
-
-
-

Lab: RBAC REST API

-
-
-
    -
  1. -

    To send requests to the RBAC API, you need a JWT token from RHDH to authenticate yourself. In RHDH, log in as a user who can access RBAC policies, and navigate to the Catalog page. Open the browser’s developer tools pane (for example, on Chrome Ctrl+Shift+C), and click the Network tab. Look for HTTP requests like entity-facets?facet=kind and click on that entry. In the Request Headers section look for the Authorization entry. Copy the token value to the clipboard.

    -
    -
    -rbac token -
    -
    Figure 4. Get the Bearer token for the logged in RHDH user
    -
    -
    2. -
  2. -

    Save the token value and RHDH URL to environment variables:

    -
    -
    -
    $ export token=<your token value>
-$ export RHDH_URL=https://backstage-rhdh-devhub.apps.cluster-<guid>.dynamic.redhatworkshops.io
    -
    -
    -
    3. -
  3. -

    Use the curl and jq CLI tools, or a REST API client, to invoke the RBAC REST API. For example, to list the policies existing in the current RHDH instance:

    -
    -
    -
    $ curl $RHDH_URL/api/permission/roles \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $token" \
-  -k -s | jq .
-[
-  {
-    "memberReferences": [
-      "user:default/rsriniva"
-    ],
-    "name": "role:default/rbac_admin",
-    "metadata": {
-      "source": "configuration",
-      "description": "The default permission policy for the admin role allows for the creation, deletion, updating, and reading of roles and permission policies.",
-      "author": "application configuration",
-      "modifiedBy": "application configuration",
-      "createdAt": "2024-06-28T11:17:50.000Z",
-      "lastModified": "2024-07-11T11:00:02.000Z"
-    }
-  },
-  {
-    "memberReferences": [
-      "user:default/rsriniva"
-    ],
-    "name": "role:default/allow-catalog-create-policy",
-    "metadata": {
-      "source": "rest",
-      "description": "This policy allows users to create catalog items",
-      "author": "user:default/rsriniva",
-      "modifiedBy": "user:default/rsriniva",
-      "createdAt": "2024-07-11T12:03:27.000Z",
-      "lastModified": "2024-07-11T12:03:27.000Z"
-    }
-  }
-]
    -
    -
    -
    -

    Consult the RBAC REST API product documentation to send other queries (POST, PUT etc) to add, modify, update and delete policies.

    -
    -
    4. -
-
-
-
-
-

References

-
-
- -
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/devhub-admin/1/index.html b/pr-preview/pr-13/devhub-admin/1/index.html deleted file mode 100644 index 401525e..0000000 --- a/pr-preview/pr-13/devhub-admin/1/index.html +++ /dev/null @@ -1,315 +0,0 @@ - - - - - - Red Hat Developer Hub Administration :: Red Hat Developer Hub Administration - - - - - - -
- -
-
- -
-
- -
- -
-

Red Hat Developer Hub Administration

-
-

Introduction

-
-
-

Welcome to this quick course on the Red Hat Developer Hub Administration. -This course is the second in a series of three courses about Red Hat Developer Hub:

-
-
-
    -
  1. -

    Introduction to Red Hat Developer Hub

    -
    2. -
  2. -

    Red Hat Developer Hub Administration (This course)

    -
    3. -
  3. -

    Building Developer Portals with Red Hat Developer Hub

    -
    4. -
-
-
-

This course covers the install, updates and uninstall process for Red Hat Developer Hub (RHDH). You also learn about the basics of configuration in RHDH, and how to configure authentication using GitHub along with configuring authorization policies using Role Based Access Control (RBAC).

-
-
- - - - - -
- - -The hands-on labs for this course have been tested on RHDH 1.2. The labs should mostly work in minor update releases of RHDH. If you encounter any issues, please open a GitHub issue in the course repository. -
-
-
-
-
-

Contributors

-
-
-

The PTL team acknowledges the valuable contributions of the following Red Hat associates:

-
-
-
    -
  • -

    Ravi Srinivasan

    -
    • -
  • -

    Jason Froehlich

    -
    • -
  • -

    Hans-Peter Grahsl

    -
    • -
  • -

    Rafael Soares

    -
    • -
  • -

    Tyrell Reddy and the entire Demo Platform (RHDP) Team

    -
    • -
  • -

    Rigin Oommen

    -
    • -
-
-
-
-
-

Classroom Environment

-
-
-

For Red Hat Associates

-
-

Red Hat associates and others who have access to the Red Hat Demo Platform (RHDP) should use the OpenShift Single Node Cluster catalog item.

-
-
-

This classroom does NOT have RHDH pre-installed. You install and configure a basic RHDH instance, and then continue using this instance with other courses in the learning path.

-
-
-

Log in to RHDP and click Order to request a new SNO cluster. In the order page for the catalog item, do the following:

-
-
-
    -
  • -

    Activity: Select Practice/Enablement

    -
    • -
  • -

    Purpose: Select Learning about the Product

    -
    • -
  • -

    Salesforce ID: If you have an opportunity ID, enter it into this field, otherwise leave this field blank

    -
    • -
  • -

    Features: Select true

    -
    • -
  • -

    OpenShift node cores: 16

    -
    • -
  • -

    OpenShift node memory size: 32GB

    -
    • -
  • -

    OpenShift Version: 4.15 or higher

    -
    • -
-
-
-

Select the checkbox at the bottom of the page to confirm that lab costs will be charged to your cost center, and click Order.

-
-
-

The lab environment will take an hour to provision. You can check the status and details of the OpenShift cluster from the Services page of RHDP.

-
-
-
-

For Red Hat Partners

-
-

Red Hat partners and others who do not have access to RHDP, should provision their own Red Hat OpenShift 4.15 cluster using the Red Hat Hybrid Cloud Console at https://console.redhat.com/openshift/overview. Ensure that you provision an OpenShift 4.15 cluster with at least 8 vCPUs and 32GB of RAM.

-
-
- - - - - -
- - -You can also install RHDH and run the hands-on labs using OpenShift Local, provided you allocate a minimum of 8 vCPUs and 24GB+ RAM. Go to https://developers.redhat.com/products/openshift-local/overview and click on Install OpenShift on your laptop. -
-
-
-
-
-
-

Prerequisites

-
-
-
    -
  • -

    Basic knowledge of OpenShift (or Kubernetes) administration

    -
    • -
  • -

    Knowledge of building Docker or Podman containers.

    -
    • -
  • -

    Deploying container images on OpenShift or Kubernetes

    -
    • -
  • -

    OpenShift or Kubernetes User and Role administration

    -
    • -
-
-
-
-
-

Objectives

-
-
-

The overall objectives of this course include:

-
-
-
    -
  • -

    Install, Upgrade and Uninstall Red Hat Developer Hub on OpenShift

    -
    • -
  • -

    Perform basic configuration of RHDH

    -
    • -
  • -

    Configure single sign-on and user authentication for Red Hat Developer Hub using GitHub

    -
    • -
  • -

    Configure authorization policies using Role Based Access Control (RBAC)

    -
    • -
-
-
-
- -
-
-
-
-
- Red Hat -
- - - diff --git a/pr-preview/pr-13/index.html b/pr-preview/pr-13/index.html deleted file mode 100644 index e67c05d..0000000 --- a/pr-preview/pr-13/index.html +++ /dev/null @@ -1,8 +0,0 @@ - - - - - -Redirect Notice -

Redirect Notice

-

The page you requested has been relocated to devhub-admin/1/index.html.