You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2019/11/06 07:16:31 UTC
svn commit: r1869438 [6/7] - in /karaf/site/production/manual/cave/latest-4:
./ images/ style/
Added: karaf/site/production/manual/cave/latest-4/repository.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/cave/latest-4/repository.html?rev=1869438&view=auto
==============================================================================
--- karaf/site/production/manual/cave/latest-4/repository.html (added)
+++ karaf/site/production/manual/cave/latest-4/repository.html Wed Nov 6 07:16:30 2019
@@ -0,0 +1,3419 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.6.1">
+<title>Installation</title>
+<style>
+/*
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+ */
+@import "https://fonts.googleapis.com/css?family=Open+Sans:400,700%7cDroid+Serif:400,700";
+
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+main,
+nav,
+section,
+summary {
+ display: block
+}
+
+audio,
+canvas,
+video {
+ display: inline-block
+}
+
+audio:not([controls]) {
+ display: none;
+ height: 0
+}
+
+script {
+ display: none !important
+}
+
+html {
+ font-family: "Droid Serif";
+ -ms-text-size-adjust: 100%;
+ -webkit-text-size-adjust: 100%;
+}
+
+a {
+ background: transparent
+}
+
+a:focus {
+ outline: thin dotted
+}
+
+a:active,
+a:hover {
+ outline: 0
+}
+
+h1 {
+ font-size: 2em;
+ margin: .67em 0
+}
+
+abbr[title] {
+ border-bottom: 1px dotted
+}
+
+b,
+strong {
+ font-weight: bold
+}
+
+dfn {
+ font-style: italic
+}
+
+hr {
+ -moz-box-sizing: content-box;
+ box-sizing: content-box;
+ height: 0
+}
+
+mark {
+ background: #ff0;
+ color: #000
+}
+
+code,
+kbd,
+pre,
+samp {
+ font-family: monospace;
+ font-size: 1em
+}
+
+pre {
+ white-space: pre-wrap
+}
+
+q {
+ quotes: "\201C" "\201D" "\2018" "\2019"
+}
+
+small {
+ font-size: 80%
+}
+
+sub,
+sup {
+ font-size: 75%;
+ line-height: 0;
+ position: relative;
+ vertical-align: baseline
+}
+
+sup {
+ top: -.5em
+}
+
+sub {
+ bottom: -.25em
+}
+
+img {
+ border: 0
+}
+
+svg:not(:root) {
+ overflow: hidden
+}
+
+figure {
+ margin: 0
+}
+
+fieldset {
+ border: 1px solid silver;
+ margin: 0 2px;
+ padding: .35em .625em .75em
+}
+
+legend {
+ border: 0;
+ padding: 0
+}
+
+button,
+input,
+select,
+textarea {
+ font-family: inherit;
+ font-size: 100%;
+ margin: 0
+}
+
+button,
+input {
+ line-height: normal
+}
+
+button,
+select {
+ text-transform: none
+}
+
+button,
+html input[type="button"],
+input[type="reset"],
+input[type="submit"] {
+ -webkit-appearance: button;
+ cursor: pointer
+}
+
+button[disabled],
+html input[disabled] {
+ cursor: default
+}
+
+input[type="checkbox"],
+input[type="radio"] {
+ box-sizing: border-box;
+ padding: 0
+}
+
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+ border: 0;
+ padding: 0
+}
+
+textarea {
+ overflow: auto;
+ vertical-align: top
+}
+
+table {
+ border-collapse: collapse;
+ border-spacing: 0
+}
+
+*,
+*::before,
+*::after {
+ -moz-box-sizing: border-box;
+ -webkit-box-sizing: border-box;
+ box-sizing: border-box
+}
+
+html,
+body {
+ /*font-size: 100%*/
+}
+
+body {
+ background: #fff;
+ color: #333;
+ padding: 0;
+ margin: 0;
+ font-family: "Droid Serif", "DejaVu Serif", serif;
+ font-size: 14px;
+ font-style: normal;
+ line-height: 1.42857143;
+ position: relative;
+ cursor: auto;
+ tab-size: 4;
+ -moz-osx-font-smoothing: grayscale;
+ -webkit-font-smoothing: antialiased
+}
+
+a:hover {
+ cursor: pointer
+}
+
+img,
+object,
+embed {
+ max-width: 100%;
+ height: auto
+}
+
+object,
+embed {
+ height: 100%
+}
+
+img {
+ -ms-interpolation-mode: bicubic
+}
+
+.left {
+ float: left !important
+}
+
+.right {
+ float: right !important
+}
+
+.text-left {
+ text-align: left !important
+}
+
+.text-right {
+ text-align: right !important
+}
+
+.text-center {
+ text-align: center !important
+}
+
+.text-justify {
+ text-align: justify !important
+}
+
+.hide {
+ display: none
+}
+
+img,
+object,
+svg {
+ display: inline-block;
+ vertical-align: middle
+}
+
+textarea {
+ height: auto;
+ min-height: 50px
+}
+
+select {
+ width: 100%
+}
+
+.center {
+ margin-left: auto;
+ margin-right: auto
+}
+
+.stretch {
+ width: 100%
+}
+
+.subheader,
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.exampleblock>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.stemblock>.title,
+.openblock>.title,
+.paragraph>.title,
+.quoteblock>.title,
+table.tableblock>.title,
+.verseblock>.title,
+.videoblock>.title,
+.dlist>.title,
+.olist>.title,
+.ulist>.title,
+.qlist>.title,
+.hdlist>.title {
+ line-height: 1.45;
+ color: #585ac2;
+ font-weight: 400;
+ margin-top: 0;
+ margin-bottom: .25em
+}
+
+div,
+dl,
+dt,
+dd,
+ul,
+ol,
+li,
+h1,
+h2,
+h3,
+#toctitle,
+.sidebarblock>.content>.title,
+h4,
+h5,
+h6,
+pre,
+form,
+p,
+blockquote,
+th,
+td {
+ margin: 0;
+ padding: 0;
+ direction: ltr
+}
+
+a {
+ color: #585ac2;
+ text-decoration: underline;
+ line-height: inherit
+}
+
+a:hover,
+a:focus {
+ color: #373997;
+}
+
+a img {
+ border: none
+}
+
+p {
+ font-family: inherit;
+ font-weight: 400;
+ font-size: 1em;
+ line-height: 1.6;
+ margin-bottom: 1.25em;
+ text-rendering: optimizeLegibility
+}
+
+p aside {
+ font-size: .875em;
+ line-height: 1.35;
+ font-style: italic
+}
+
+h1,
+h2,
+h3,
+#toctitle,
+.sidebarblock>.content>.title,
+h4,
+h5,
+h6 {
+ font-family: "Source Sans Pro", "DejaVu Sans", sans-serif;
+ font-weight: bold;
+ /*font-style: bold;*/
+ color: #303284;
+ text-rendering: optimizeLegibility;
+ margin-top: 1em;
+ margin-bottom: .5em;
+ line-height: 1.0125em;
+ text-transform: uppercase;
+}
+
+h1 small,
+h2 small,
+h3 small,
+#toctitle small,
+.sidebarblock>.content>.title small,
+h4 small,
+h5 small,
+h6 small {
+ font-size: 60%;
+ color: #303284;
+ line-height: 0
+}
+
+h1 {
+ font-size: 2.125em
+}
+
+h2 {
+ font-size: 1.6875em
+}
+
+h3,
+#toctitle,
+.sidebarblock>.content>.title {
+ font-size: 1.375em
+}
+
+h4,
+h5 {
+ font-size: 1.125em
+}
+
+h6 {
+ font-size: 1em
+}
+
+hr {
+ border: solid #dddddd;
+ border-width: 1px 0 0;
+ clear: both;
+ margin: 1.25em 0 1.1875em;
+ height: 0
+}
+
+em,
+i {
+ font-style: italic;
+ line-height: inherit
+}
+
+strong,
+b {
+ font-weight: bold;
+ line-height: inherit
+}
+
+small {
+ font-size: 60%;
+ line-height: inherit
+}
+
+code {
+ font-family: "Droid Sans Mono", "DejaVu Sans Mono", monospace;
+ font-weight: 400;
+ color: #585ac2;
+}
+
+ul,
+ol,
+dl {
+ font-size: 1em;
+ line-height: 1.6;
+ margin-bottom: 1.25em;
+ list-style-position: outside;
+ font-family: inherit
+}
+
+ul,
+ol {
+ margin-left: 1.5em
+}
+
+ul li ul,
+ul li ol {
+ margin-left: 1.25em;
+ margin-bottom: 0;
+ font-size: 1em
+}
+
+ul.square li ul,
+ul.circle li ul,
+ul.disc li ul {
+ list-style: inherit
+}
+
+ul.square {
+ list-style-type: square
+}
+
+ul.circle {
+ list-style-type: circle
+}
+
+ul.disc {
+ list-style-type: disc
+}
+
+ol li ul,
+ol li ol {
+ margin-left: 1.25em;
+ margin-bottom: 0
+}
+
+dl dt {
+ margin-bottom: .3125em;
+ font-weight: bold
+}
+
+dl dd {
+ margin-bottom: 1.25em
+}
+
+abbr,
+acronym {
+ text-transform: uppercase;
+ font-size: 90%;
+ color: rgba(0, 0, 0, .8);
+ border-bottom: 1px dotted #ddd;
+ cursor: help
+}
+
+abbr {
+ text-transform: none
+}
+
+blockquote {
+ margin: 0 0 1.25em;
+ padding: .5625em 1.25em 0 1.1875em;
+ border-left: 1px solid #ddd
+}
+
+blockquote cite {
+ display: block;
+ font-size: .9375em;
+ color: rgba(0, 0, 0, .6)
+}
+
+blockquote cite::before {
+ content: "\2014 \0020"
+}
+
+blockquote cite a,
+blockquote cite a:visited {
+ color: rgba(0, 0, 0, .6)
+}
+
+blockquote,
+blockquote p {
+ line-height: 1.6;
+ color: rgba(0, 0, 0, .85)
+}
+
+@media screen and (min-width:768px) {
+ h1,
+ h2,
+ h3,
+ #toctitle,
+ .sidebarblock>.content>.title,
+ h4,
+ h5,
+ h6 {
+ line-height: 1.2
+ }
+
+ h1 {
+ font-size: 2.75em
+ }
+
+ h2 {
+ font-size: 2.3125em
+ }
+
+ h3,
+ #toctitle,
+ .sidebarblock>.content>.title {
+ font-size: 1.6875em
+ }
+
+ h4 {
+ font-size: 1.4375em
+ }
+
+}
+
+table {
+ background: #fff;
+ margin-bottom: 1.25em;
+ border: solid 1px #dddddd;
+}
+
+table thead,
+table tfoot {
+ background: #f7f8f7
+}
+
+table thead tr th,
+table thead tr td,
+table tfoot tr th,
+table tfoot tr td {
+ padding: .5em .625em .625em;
+ font-size: inherit;
+ color: rgba(0, 0, 0, .8);
+ text-align: left
+}
+
+table tr th,
+table tr td {
+ padding: .5625em .625em;
+ font-size: inherit;
+ color: rgba(0, 0, 0, .8)
+}
+
+table tr.even,
+table tr.alt,
+table tr:nth-of-type(even) {
+ background: #f8f8f7
+}
+
+table thead tr th,
+table tfoot tr th,
+table tbody tr td,
+table tr td,
+table tfoot tr td {
+ display: table-cell;
+ line-height: 1.6
+}
+
+h1,
+h2,
+h3,
+#toctitle,
+.sidebarblock>.content>.title,
+h4,
+h5,
+h6 {
+ line-height: 1.2;
+ word-spacing: -.05em
+}
+
+h1 strong,
+h2 strong,
+h3 strong,
+#toctitle strong,
+.sidebarblock>.content>.title strong,
+h4 strong,
+h5 strong,
+h6 strong {
+ font-weight: 400
+}
+
+.clearfix::before,
+.clearfix::after,
+.float-group::before,
+.float-group::after {
+ content: " ";
+ display: table
+}
+
+.clearfix::after,
+.float-group::after {
+ clear: both
+}
+
+*:not(pre)>code {
+ font-size: .9375em;
+ font-style: normal !important;
+ letter-spacing: 0;
+ padding: .1em .5ex;
+ word-spacing: -.15em;
+ background-color: #f7f7f8;
+ -webkit-border-radius: 4px;
+ border-radius: 4px;
+ line-height: 1.45;
+ text-rendering: optimizeSpeed;
+ word-wrap: break-word
+}
+
+*:not(pre)>code.nobreak {
+ word-wrap: normal
+}
+
+*:not(pre)>code.nowrap {
+ white-space: nowrap
+}
+
+pre,
+pre>code {
+ line-height: 1.45;
+ color: #585ac2;
+ font-family: "Droid Sans Mono", "DejaVu Sans Mono", monospace;
+ font-weight: 400;
+ text-rendering: optimizeSpeed
+}
+
+em em {
+ font-style: normal
+}
+
+strong strong {
+ font-weight: 400
+}
+
+.keyseq {
+ color: rgba(51, 51, 51, .8)
+}
+
+kbd {
+ font-family: "Droid Sans Mono", "DejaVu Sans Mono", monospace;
+ display: inline-block;
+ color: rgba(0, 0, 0, .8);
+ font-size: .65em;
+ line-height: 1.45;
+ background-color: #f7f7f7;
+ border: 1px solid #dddddd;
+ -webkit-border-radius: 3px;
+ border-radius: 3px;
+ -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em white inset;
+ box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;
+ margin: 0 .15em;
+ padding: .2em .5em;
+ vertical-align: middle;
+ position: relative;
+ top: -.1em;
+ white-space: nowrap
+}
+
+.keyseq kbd:first-child {
+ margin-left: 0
+}
+
+.keyseq kbd:last-child {
+ margin-right: 0
+}
+
+.menuseq,
+.menuref {
+ color: #000
+}
+
+.menuseq b:not(.caret),.menuref {
+ font-weight: inherit
+}
+
+.menuseq {
+ word-spacing: -.02em
+}
+
+.menuseq b.caret {
+ font-size: 1.25em;
+ line-height: .8
+}
+
+.menuseq i.caret {
+ font-weight: bold;
+ text-align: center;
+ width: .45em
+}
+
+b.button::before,
+b.button::after {
+ position: relative;
+ top: -1px;
+ font-weight: 400
+}
+
+b.button::before {
+ content: "[";
+ padding: 0 3px 0 2px
+}
+
+b.button::after {
+ content: "]";
+ padding: 0 2px 0 3px
+}
+
+p a>code:hover {
+ color: #585ac2;
+}
+
+#header,
+#content,
+#footnotes,
+#footer {
+ width: 100%;
+ margin-left: auto;
+ margin-right: auto;
+ margin-top: 0;
+ margin-bottom: 0;
+ max-width: 62.5em;
+ *zoom: 1;
+ position: relative;
+ padding-left: .9375em;
+ padding-right: .9375em
+}
+
+#header::before,
+#header::after,
+#content::before,
+#content::after,
+#footnotes::before,
+#footnotes::after,
+#footer::before,
+#footer::after {
+ content: " ";
+ display: table
+}
+
+#header::after,
+#content::after,
+#footnotes::after,
+#footer::after {
+ clear: both
+}
+
+#content {
+ margin-top: 1.25em
+}
+
+#content::before {
+ content: none
+}
+
+#header>h1:first-child {
+ color: #303284;
+ margin-top: 2.25rem;
+ margin-bottom: 0
+}
+
+#header>h1:first-child+#toc {
+ margin-top: 8px;
+ border-top: 1px solid #dddddd
+}
+
+#header>h1:only-child,
+body.toc2 #header>h1:nth-last-child(2) {
+ border-bottom: 1px solid #dddddd;
+ padding-bottom: 8px
+}
+
+#header .details {
+ border-bottom: 1px solid #dddddd;
+ line-height: 1.45;
+ padding-top: .25em;
+ padding-bottom: .25em;
+ padding-left: .25em;
+ color: rgba(0, 0, 0, .6);
+ display: -ms-flexbox;
+ display: -webkit-flex;
+ display: flex;
+ -ms-flex-flow: row wrap;
+ -webkit-flex-flow: row wrap;
+ flex-flow: row wrap
+}
+
+#header .details span:first-child {
+ margin-left: -.125em
+}
+
+#header .details span.email a {
+ color: rgba(0, 0, 0, .85)
+}
+
+#header .details br {
+ display: none
+}
+
+#header .details br+span::before {
+ content: "\00a0\2013\00a0"
+}
+
+#header .details br+span.author::before {
+ content: "\00a0\22c5\00a0";
+ color: rgba(0, 0, 0, .85)
+}
+
+#header .details br+span#revremark::before {
+ content: "\00a0|\00a0"
+}
+
+#header #revnumber {
+ text-transform: capitalize
+}
+
+#header #revnumber::after {
+ content: "\00a0"
+}
+
+#content>h1:first-child:not([class]) {
+ color: rgba(0, 0, 0, .85);
+ border-bottom: 1px solid #dddddd
+;
+ padding-bottom: 8px;
+ margin-top: 0;
+ padding-top: 1rem;
+ margin-bottom: 1.25rem
+}
+
+#toc {
+ border-bottom: 1px solid #dddddd;
+ padding-bottom: .5em
+}
+
+#toc>ul {
+ margin-left: .125em
+}
+
+#toc ul.sectlevel0>li>a {
+ font-style: italic
+}
+
+#toc ul.sectlevel0 ul.sectlevel1 {
+ margin: .5em 0
+}
+
+#toc ul {
+ font-family: "Droid Serif", "DejaVu Sans", sans-serif;
+ list-style-type: none
+}
+
+#toc li {
+ line-height: 1.3334;
+ margin-top: .3334em
+}
+
+#toc a {
+ text-decoration: none
+}
+
+#toc a:active {
+ text-decoration: underline
+}
+
+#toctitle {
+ color: #303284;
+ font-size: 1.2em
+}
+
+@media screen and (min-width:768px) {
+ #toctitle {
+ font-size: 1.375em
+ }
+
+ body.toc2 {
+ padding-left: 15em;
+ padding-right: 0
+ }
+
+ #toc.toc2 {
+ margin-top: 0 !important;
+ background-color: #eee;
+ position: fixed;
+ width: 15em;
+ left: 0;
+ top: 0;
+ border-right: 1px solid #dddddd;
+ border-top-width: 0 !important;
+ border-bottom-width: 0 !important;
+ z-index: 1000;
+ padding: 1.25em 1em;
+ height: 100%;
+ overflow: auto
+ }
+
+ #toc.toc2 #toctitle {
+ margin-top: 0;
+ margin-bottom: .8rem;
+ font-size: 1.2em
+ }
+
+ #toc.toc2>ul {
+ font-size: .9em;
+ margin-bottom: 0
+ }
+
+ #toc.toc2 ul ul {
+ margin-left: 0;
+ padding-left: 1em
+ }
+
+ #toc.toc2 ul.sectlevel0 ul.sectlevel1 {
+ padding-left: 0;
+ margin-top: .5em;
+ margin-bottom: .5em
+ }
+
+ body.toc2.toc-right {
+ padding-left: 0;
+ padding-right: 15em
+ }
+
+ body.toc2.toc-right #toc.toc2 {
+ border-right-width: 0;
+ border-left: 1px solid #dddddd;
+ left: auto;
+ right: 0
+ }
+
+}
+
+@media screen and (min-width:1280px) {
+ body.toc2 {
+ padding-left: 20em;
+ padding-right: 0
+ }
+
+ #toc.toc2 {
+ width: 20em
+ }
+
+ #toc.toc2 #toctitle {
+ font-size: 1.375em
+ }
+
+ #toc.toc2>ul {
+ font-size: .95em
+ }
+
+ #toc.toc2 ul ul {
+ padding-left: 1.25em
+ }
+
+ body.toc2.toc-right {
+ padding-left: 0;
+ padding-right: 20em
+ }
+
+}
+
+#content #toc {
+ border-style: solid;
+ border-width: 1px;
+ border-color: #dddddd;
+ margin-bottom: 1.25em;
+ padding: 1.25em;
+ background: #f8f8f7;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+#content #toc>:first-child {
+ margin-top: 0
+}
+
+#content #toc>:last-child {
+ margin-bottom: 0
+}
+
+#footer {
+ max-width: 100%;
+ background-color: #303284;
+ padding: 1.25em
+}
+
+#footer-text {
+ color: #fff;
+ line-height: 1.44
+}
+
+#content {
+ margin-bottom: .625em
+}
+
+.sect1 {
+ padding-bottom: .625em
+}
+
+@media screen and (min-width:768px) {
+ #content {
+ margin-bottom: 1.25em
+ }
+
+ .sect1 {
+ padding-bottom: 1.25em
+ }
+
+}
+
+.sect1:last-child {
+ padding-bottom: 0
+}
+
+.sect1+.sect1 {
+ border-top: 1px solid #dddddd;
+}
+
+#content h1>a.anchor,
+h2>a.anchor,
+h3>a.anchor,
+#toctitle>a.anchor,
+.sidebarblock>.content>.title>a.anchor,
+h4>a.anchor,
+h5>a.anchor,
+h6>a.anchor {
+ position: absolute;
+ z-index: 1001;
+ width: 1.5ex;
+ margin-left: -1.5ex;
+ display: block;
+ text-decoration: none !important;
+ visibility: hidden;
+ text-align: center;
+ font-weight: 400
+}
+
+#content h1>a.anchor::before,
+h2>a.anchor::before,
+h3>a.anchor::before,
+#toctitle>a.anchor::before,
+.sidebarblock>.content>.title>a.anchor::before,
+h4>a.anchor::before,
+h5>a.anchor::before,
+h6>a.anchor::before {
+ content: "\00A7";
+ font-size: .85em;
+ display: block;
+ padding-top: .1em
+}
+
+#content h1:hover>a.anchor,
+#content h1>a.anchor:hover,
+h2:hover>a.anchor,
+h2>a.anchor:hover,
+h3:hover>a.anchor,
+#toctitle:hover>a.anchor,
+.sidebarblock>.content>.title:hover>a.anchor,
+h3>a.anchor:hover,
+#toctitle>a.anchor:hover,
+.sidebarblock>.content>.title>a.anchor:hover,
+h4:hover>a.anchor,
+h4>a.anchor:hover,
+h5:hover>a.anchor,
+h5>a.anchor:hover,
+h6:hover>a.anchor,
+h6>a.anchor:hover {
+ visibility: visible
+}
+
+#content h1>a.link,
+h2>a.link,
+h3>a.link,
+#toctitle>a.link,
+.sidebarblock>.content>.title>a.link,
+h4>a.link,
+h5>a.link,
+h6>a.link {
+ color: #ba3925;
+ text-decoration: none
+}
+
+#content h1>a.link:hover,
+h2>a.link:hover,
+h3>a.link:hover,
+#toctitle>a.link:hover,
+.sidebarblock>.content>.title>a.link:hover,
+h4>a.link:hover,
+h5>a.link:hover,
+h6>a.link:hover {
+ color: #a53221
+}
+
+.audioblock,
+.imageblock,
+.literalblock,
+.listingblock,
+.stemblock,
+.videoblock {
+ margin-bottom: 1.25em
+}
+
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.exampleblock>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.stemblock>.title,
+.openblock>.title,
+.paragraph>.title,
+.quoteblock>.title,
+table.tableblock>.title,
+.verseblock>.title,
+.videoblock>.title,
+.dlist>.title,
+.olist>.title,
+.ulist>.title,
+.qlist>.title,
+.hdlist>.title {
+ text-rendering: optimizeLegibility;
+ text-align: left;
+ font-family: "Droid Serif", "DejaVu Serif", serif;
+ font-size: 1rem;
+ font-style: italic
+}
+
+table.tableblock.fit-content>caption.title {
+ white-space: nowrap;
+ width: 0
+}
+
+.paragraph.lead>p,
+#preamble>.sectionbody>[class="paragraph"]:first-of-type p {
+ font-size: 1.21875em;
+ line-height: 1.6;
+ color: rgba(0, 0, 0, .85)
+}
+
+table.tableblock #preamble>.sectionbody>[class="paragraph"]:first-of-type p {
+ font-size: inherit
+}
+
+.admonitionblock>table {
+ border-collapse: separate;
+ border: 0;
+ background: none;
+ width: 100%
+}
+
+.admonitionblock>table td.icon {
+ text-align: center;
+ width: 80px
+}
+
+.admonitionblock>table td.icon img {
+ max-width: none
+}
+
+.admonitionblock>table td.icon .title {
+ font-weight: bold;
+ font-family: "Source Sans Pro", "DejaVu Sans", sans-serif;
+ text-transform: uppercase
+}
+
+.admonitionblock>table td.content {
+ padding-left: 1.125em;
+ padding-right: 1.25em;
+ border-left: 1px solid #dddddd;
+ color: rgba(0, 0, 0, .6)
+}
+
+.admonitionblock>table td.content>:last-child>:last-child {
+ margin-bottom: 0
+}
+
+.exampleblock>.content {
+ border-style: solid;
+ border-width: 1px;
+ border-color: #dddddd;
+ margin-bottom: 1.25em;
+ padding: 1.25em;
+ background: #fff;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+.exampleblock>.content>:first-child {
+ margin-top: 0
+}
+
+.exampleblock>.content>:last-child {
+ margin-bottom: 0
+}
+
+.sidebarblock {
+ border-style: solid;
+ border-width: 1px;
+ border-color: #dddddd;
+ margin-bottom: 1.25em;
+ padding: 1.25em;
+ background: #f8f8f7;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+.sidebarblock>:first-child {
+ margin-top: 0
+}
+
+.sidebarblock>:last-child {
+ margin-bottom: 0
+}
+
+.sidebarblock>.content>.title {
+ color: #303284;
+ margin-top: 0;
+ text-align: center
+}
+
+.exampleblock>.content>:last-child>:last-child,
+.exampleblock>.content .olist>ol>li:last-child>:last-child,
+.exampleblock>.content .ulist>ul>li:last-child>:last-child,
+.exampleblock>.content .qlist>ol>li:last-child>:last-child,
+.sidebarblock>.content>:last-child>:last-child,
+.sidebarblock>.content .olist>ol>li:last-child>:last-child,
+.sidebarblock>.content .ulist>ul>li:last-child>:last-child,
+.sidebarblock>.content .qlist>ol>li:last-child>:last-child {
+ margin-bottom: 0
+}
+
+.literalblock pre,
+.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint {
+ background: #f7f7f8
+}
+
+.sidebarblock .literalblock pre,
+.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint {
+ background: #f2f1f1
+}
+
+.literalblock pre,
+.literalblock pre[class],
+.listingblock pre,
+.listingblock pre[class] {
+ -webkit-border-radius: 4px;
+ border-radius: 4px;
+ word-wrap: break-word;
+ padding: 1em;
+ font-size: .8125em
+}
+
+.literalblock pre.nowrap,
+.literalblock pre[class].nowrap,
+.listingblock pre.nowrap,
+.listingblock pre[class].nowrap {
+ overflow-x: auto;
+ white-space: pre;
+ word-wrap: normal
+}
+
+@media screen and (min-width:768px) {
+ .literalblock pre,
+ .literalblock pre[class],
+ .listingblock pre,
+ .listingblock pre[class] {
+ font-size: .90625em
+ }
+
+}
+
+@media screen and (min-width:1280px) {
+ .literalblock pre,
+ .literalblock pre[class],
+ .listingblock pre,
+ .listingblock pre[class] {
+ font-size: 1em
+ }
+
+}
+
+.literalblock.output pre {
+ color: #f7f7f8;
+ background-color: rgba(0, 0, 0, .9)
+}
+
+.listingblock pre.highlightjs {
+ padding: 0
+}
+
+.listingblock pre.highlightjs>code {
+ padding: 1em;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+.listingblock pre.prettyprint {
+ border-width: 0
+}
+
+.listingblock>.content {
+ position: relative
+}
+
+.listingblock code[data-lang]::before {
+ display: none;
+ content: attr(data-lang);
+ position: absolute;
+ font-size: .75em;
+ top: .425rem;
+ right: .5rem;
+ line-height: 1;
+ text-transform: uppercase;
+ color: #999
+}
+
+.listingblock:hover code[data-lang]::before {
+ display: block
+}
+
+.listingblock.terminal pre .command::before {
+ content: attr(data-prompt);
+ padding-right: .5em;
+ color: #999
+}
+
+.listingblock.terminal pre .command:not([data-prompt])::before {
+ content: "$"
+}
+
+table.pyhltable {
+ border-collapse: separate;
+ border: 0;
+ margin-bottom: 0;
+ background: none
+}
+
+table.pyhltable td {
+ vertical-align: top;
+ padding-top: 0;
+ padding-bottom: 0;
+ line-height: 1.45
+}
+
+table.pyhltable td.code {
+ padding-left: .75em;
+ padding-right: 0
+}
+
+pre.pygments .lineno,
+table.pyhltable td:not(.code) {
+ color: #999;
+ padding-left: 0;
+ padding-right: .5em;
+ border-right: 1px solid #dddddd;
+}
+
+pre.pygments .lineno {
+ display: inline-block;
+ margin-right: .25em
+}
+
+table.pyhltable .linenodiv {
+ background: none !important;
+ padding-right: 0 !important
+}
+
+.quoteblock {
+ margin: 0 1em 1.25em 1.5em;
+ display: table
+}
+
+.quoteblock>.title {
+ margin-left: -1.5em;
+ margin-bottom: .75em
+}
+
+.quoteblock blockquote,
+.quoteblock blockquote p {
+ color: rgba(0, 0, 0, .85);
+ font-size: 1.05rem;
+ line-height: 1.75;
+ word-spacing: .1em;
+ letter-spacing: 0;
+ font-style: italic;
+ text-align: justify
+}
+
+.quoteblock blockquote {
+ margin: 0;
+ padding: 0;
+ border: 0
+}
+
+.quoteblock blockquote::before {
+ content: "\201c";
+ float: left;
+ font-size: 2.75em;
+ font-weight: bold;
+ line-height: .6em;
+ margin-left: -.6em;
+ color: #303284;
+ text-shadow: 0 1px 2px rgba(0, 0, 0, .1)
+}
+
+.quoteblock blockquote>.paragraph:last-child p {
+ margin-bottom: 0
+}
+
+.quoteblock .attribution {
+ margin-top: .5em;
+ margin-right: .5ex;
+ text-align: right
+}
+
+.quoteblock .quoteblock {
+ margin-left: 0;
+ margin-right: 0;
+ padding: .5em 0;
+ border-left: 3px solid rgba(0, 0, 0, .6)
+}
+
+.quoteblock .quoteblock blockquote {
+ padding: 0 0 0 .75em
+}
+
+.quoteblock .quoteblock blockquote::before {
+ display: none
+}
+
+.verseblock {
+ margin: 0 1em 1.25em
+}
+
+.verseblock pre {
+ font-family: "Source Sans Pro", "DejaVu Sans", sans;
+ font-size: 1.15rem;
+ color: rgba(0, 0, 0, .85);
+ font-weight: 300;
+ text-rendering: optimizeLegibility
+}
+
+.verseblock pre strong {
+ font-weight: 400
+}
+
+.verseblock .attribution {
+ margin-top: 1.25rem;
+ margin-left: .5ex
+}
+
+.quoteblock .attribution,
+.verseblock .attribution {
+ font-size: .9375em;
+ line-height: 1.45;
+ font-style: italic
+}
+
+.quoteblock .attribution br,
+.verseblock .attribution br {
+ display: none
+}
+
+.quoteblock .attribution cite,
+.verseblock .attribution cite {
+ display: block;
+ letter-spacing: -.025em;
+ color: rgba(0, 0, 0, .6)
+}
+
+.quoteblock.abstract {
+ margin: 0 1em 1.25em;
+ display: block
+}
+
+.quoteblock.abstract>.title {
+ margin: 0 0 .375em;
+ font-size: 1.15em;
+ text-align: center
+}
+
+.quoteblock.abstract blockquote,
+.quoteblock.abstract blockquote p {
+ word-spacing: 0;
+ line-height: 1.6
+}
+
+.quoteblock.abstract blockquote::before,
+.quoteblock.abstract p::before {
+ display: none
+}
+
+table.tableblock {
+ max-width: 100%;
+ border-collapse: separate
+}
+
+p.tableblock:last-child {
+ margin-bottom: 0
+}
+
+td.tableblock>.content {
+ margin-bottom: -1.25em
+}
+
+table.tableblock,
+th.tableblock,
+td.tableblock {
+ border: 0 solid #dddddd;
+}
+
+table.grid-all>thead>tr>.tableblock,
+table.grid-all>tbody>tr>.tableblock {
+ border-width: 0 1px 1px 0
+}
+
+table.grid-all>tfoot>tr>.tableblock {
+ border-width: 1px 1px 0 0
+}
+
+table.grid-cols>*>tr>.tableblock {
+ border-width: 0 1px 0 0
+}
+
+table.grid-rows>thead>tr>.tableblock,
+table.grid-rows>tbody>tr>.tableblock {
+ border-width: 0 0 1px
+}
+
+table.grid-rows>tfoot>tr>.tableblock {
+ border-width: 1px 0 0
+}
+
+table.grid-all>*>tr>.tableblock:last-child,
+table.grid-cols>*>tr>.tableblock:last-child {
+ border-right-width: 0
+}
+
+table.grid-all>tbody>tr:last-child>.tableblock,
+table.grid-all>thead:last-child>tr>.tableblock,
+table.grid-rows>tbody>tr:last-child>.tableblock,
+table.grid-rows>thead:last-child>tr>.tableblock {
+ border-bottom-width: 0
+}
+
+table.frame-all {
+ border-width: 1px
+}
+
+table.frame-sides {
+ border-width: 0 1px
+}
+
+table.frame-topbot,
+table.frame-ends {
+ border-width: 1px 0
+}
+
+table.stripes-all tr,
+table.stripes-odd tr:nth-of-type(odd) {
+ background: #f8f8f7
+}
+
+table.stripes-none tr,
+table.stripes-odd tr:nth-of-type(even) {
+ background: none
+}
+
+th.halign-left,
+td.halign-left {
+ text-align: left
+}
+
+th.halign-right,
+td.halign-right {
+ text-align: right
+}
+
+th.halign-center,
+td.halign-center {
+ text-align: center
+}
+
+th.valign-top,
+td.valign-top {
+ vertical-align: top
+}
+
+th.valign-bottom,
+td.valign-bottom {
+ vertical-align: bottom
+}
+
+th.valign-middle,
+td.valign-middle {
+ vertical-align: middle
+}
+
+table thead th,
+table tfoot th {
+ font-weight: bold
+}
+
+tbody tr th {
+ display: table-cell;
+ line-height: 1.6;
+ background: #f7f8f7
+}
+
+tbody tr th,
+tbody tr th p,
+tfoot tr th,
+tfoot tr th p {
+ color: rgba(0, 0, 0, .8);
+ font-weight: bold
+}
+
+p.tableblock>code:only-child {
+ background: none;
+ padding: 0
+}
+
+p.tableblock {
+ font-size: 1em
+}
+
+td>div.verse {
+ white-space: pre
+}
+
+ol {
+ margin-left: 1.75em
+}
+
+ul li ol {
+ margin-left: 1.5em
+}
+
+dl dd {
+ margin-left: 1.125em
+}
+
+dl dd:last-child,
+dl dd:last-child>:last-child {
+ margin-bottom: 0
+}
+
+ol>li p,
+ul>li p,
+ul dd,
+ol dd,
+.olist .olist,
+.ulist .ulist,
+.ulist .olist,
+.olist .ulist {
+ margin-bottom: .625em
+}
+
+ul.checklist,
+ul.none,
+ol.none,
+ul.no-bullet,
+ol.no-bullet,
+ol.unnumbered,
+ul.unstyled,
+ol.unstyled {
+ list-style-type: none
+}
+
+ul.no-bullet,
+ol.no-bullet,
+ol.unnumbered {
+ margin-left: .625em
+}
+
+ul.unstyled,
+ol.unstyled {
+ margin-left: 0
+}
+
+ul.checklist {
+ margin-left: .625em
+}
+
+ul.checklist li>p:first-child>.fa-square-o:first-child,
+ul.checklist li>p:first-child>.fa-check-square-o:first-child {
+ width: 1.25em;
+ font-size: .8em;
+ position: relative;
+ bottom: .125em
+}
+
+ul.checklist li>p:first-child>input[type="checkbox"]:first-child {
+ margin-right: .25em
+}
+
+ul.inline {
+ display: -ms-flexbox;
+ display: -webkit-box;
+ display: flex;
+ -ms-flex-flow: row wrap;
+ -webkit-flex-flow: row wrap;
+ flex-flow: row wrap;
+ list-style: none;
+ margin: 0 0 .625em -1.25em
+}
+
+ul.inline>li {
+ margin-left: 1.25em
+}
+
+.unstyled dl dt {
+ font-weight: 400;
+ font-style: normal
+}
+
+ol.arabic {
+ list-style-type: decimal
+}
+
+ol.decimal {
+ list-style-type: decimal-leading-zero
+}
+
+ol.loweralpha {
+ list-style-type: lower-alpha
+}
+
+ol.upperalpha {
+ list-style-type: upper-alpha
+}
+
+ol.lowerroman {
+ list-style-type: lower-roman
+}
+
+ol.upperroman {
+ list-style-type: upper-roman
+}
+
+ol.lowergreek {
+ list-style-type: lower-greek
+}
+
+.hdlist>table,
+.colist>table {
+ border: 0;
+ background: none
+}
+
+.hdlist>table>tbody>tr,
+.colist>table>tbody>tr {
+ background: none
+}
+
+td.hdlist1,
+td.hdlist2 {
+ vertical-align: top;
+ padding: 0 .625em
+}
+
+td.hdlist1 {
+ font-weight: bold;
+ padding-bottom: 1.25em
+}
+
+.literalblock+.colist,
+.listingblock+.colist {
+ margin-top: -.5em
+}
+
+.colist td:not([class]):first-child {
+ padding: .4em .75em 0;
+ line-height: 1;
+ vertical-align: top
+}
+
+.colist td:not([class]):first-child img {
+ max-width: none
+}
+
+.colist td:not([class]):last-child {
+ padding: .25em 0
+}
+
+.thumb,
+.th {
+ line-height: 0;
+ display: inline-block;
+ border: solid 4px #fff;
+ -webkit-box-shadow: 0 0 0 1px #ddd;
+ box-shadow: 0 0 0 1px #ddd
+}
+
+.imageblock.left,
+.imageblock[style*="float:left"] {
+ margin: .25em .625em 1.25em 0
+}
+
+.imageblock.right,
+.imageblock[style*="float:right"] {
+ margin: .25em 0 1.25em .625em
+}
+
+.imageblock>.title {
+ margin-bottom: 0
+}
+
+.imageblock.thumb,
+.imageblock.th {
+ border-width: 6px
+}
+
+.imageblock.thumb>.title,
+.imageblock.th>.title {
+ padding: 0 .125em
+}
+
+.image.left,
+.image.right {
+ margin-top: .25em;
+ margin-bottom: .25em;
+ display: inline-block;
+ line-height: 0
+}
+
+.image.left {
+ margin-right: .625em
+}
+
+.image.right {
+ margin-left: .625em
+}
+
+a.image {
+ text-decoration: none;
+ display: inline-block
+}
+
+a.image object {
+ pointer-events: none
+}
+
+sup.footnote,
+sup.footnoteref {
+ font-size: .875em;
+ position: static;
+ vertical-align: super
+}
+
+sup.footnote a,
+sup.footnoteref a {
+ text-decoration: none
+}
+
+sup.footnote a:active,
+sup.footnoteref a:active {
+ text-decoration: underline
+}
+
+#footnotes {
+ padding-top: .75em;
+ padding-bottom: .75em;
+ margin-bottom: .625em
+}
+
+#footnotes hr {
+ width: 20%;
+ min-width: 6.25em;
+ margin: -.25em 0 .75em;
+ border-width: 1px 0 0
+}
+
+#footnotes .footnote {
+ padding: 0 .375em 0 .225em;
+ line-height: 1.3334;
+ font-size: .875em;
+ margin-left: 1.2em;
+ margin-bottom: .2em
+}
+
+#footnotes .footnote a:first-of-type {
+ font-weight: bold;
+ text-decoration: none;
+ margin-left: -1.05em
+}
+
+#footnotes .footnote:last-of-type {
+ margin-bottom: 0
+}
+
+#content #footnotes {
+ margin-top: -.625em;
+ margin-bottom: 0;
+ padding: .75em 0
+}
+
+.gist .file-data>table {
+ border: 0;
+ background: #fff;
+ width: 100%;
+ margin-bottom: 0
+}
+
+.gist .file-data>table td.line-data {
+ width: 99%
+}
+
+div.unbreakable {
+ page-break-inside: avoid
+}
+
+.big {
+ font-size: larger
+}
+
+.small {
+ font-size: smaller
+}
+
+.underline {
+ text-decoration: underline
+}
+
+.overline {
+ text-decoration: overline
+}
+
+.line-through {
+ text-decoration: line-through
+}
+
+.aqua {
+ color: #00bfbf
+}
+
+.aqua-background {
+ background-color: #00fafa
+}
+
+.black {
+ color: #000
+}
+
+.black-background {
+ background-color: #000
+}
+
+.blue {
+ color: #0000bf
+}
+
+.blue-background {
+ background-color: #0000fa
+}
+
+.fuchsia {
+ color: #bf00bf
+}
+
+.fuchsia-background {
+ background-color: #fa00fa
+}
+
+.gray {
+ color: #606060
+}
+
+.gray-background {
+ background-color: #7d7d7d
+}
+
+.green {
+ color: #006000
+}
+
+.green-background {
+ background-color: #007d00
+}
+
+.lime {
+ color: #00bf00
+}
+
+.lime-background {
+ background-color: #00fa00
+}
+
+.maroon {
+ color: #600000
+}
+
+.maroon-background {
+ background-color: #7d0000
+}
+
+.navy {
+ color: #000060
+}
+
+.navy-background {
+ background-color: #00007d
+}
+
+.olive {
+ color: #606000
+}
+
+.olive-background {
+ background-color: #7d7d00
+}
+
+.purple {
+ color: #600060
+}
+
+.purple-background {
+ background-color: #7d007d
+}
+
+.red {
+ color: #bf0000
+}
+
+.red-background {
+ background-color: #fa0000
+}
+
+.silver {
+ color: #909090
+}
+
+.silver-background {
+ background-color: #bcbcbc
+}
+
+.teal {
+ color: #006060
+}
+
+.teal-background {
+ background-color: #007d7d
+}
+
+.white {
+ color: #bfbfbf
+}
+
+.white-background {
+ background-color: #fafafa
+}
+
+.yellow {
+ color: #bfbf00
+}
+
+.yellow-background {
+ background-color: #fafa00
+}
+
+span.icon>.fa {
+ cursor: default
+}
+
+a span.icon>.fa {
+ cursor: inherit
+}
+
+.admonitionblock td.icon [class^="fa icon-"] {
+ font-size: 2.5em;
+ text-shadow: 1px 1px 2px rgba(0, 0, 0, .5);
+ cursor: default
+}
+
+.admonitionblock td.icon .icon-note::before {
+ content: "\f05a";
+ color: #19407c
+}
+
+.admonitionblock td.icon .icon-tip::before {
+ content: "\f0eb";
+ text-shadow: 1px 1px 2px rgba(155, 155, 0, .8);
+ color: #111
+}
+
+.admonitionblock td.icon .icon-warning::before {
+ content: "\f071";
+ color: #bf6900
+}
+
+.admonitionblock td.icon .icon-caution::before {
+ content: "\f06d";
+ color: #bf3400
+}
+
+.admonitionblock td.icon .icon-important::before {
+ content: "\f06a";
+ color: #bf0000
+}
+
+.conum[data-value] {
+ display: inline-block;
+ color: #fff !important;
+ background-color: rgba(0, 0, 0, .8);
+ -webkit-border-radius: 100px;
+ border-radius: 100px;
+ text-align: center;
+ font-size: .75em;
+ width: 1.67em;
+ height: 1.67em;
+ line-height: 1.67em;
+ font-family: "Source Sans Pro", "DejaVu Sans", sans-serif;
+ font-style: normal;
+ font-weight: bold
+}
+
+.conum[data-value] * {
+ color: #fff !important
+}
+
+.conum[data-value]+b {
+ display: none
+}
+
+.conum[data-value]::after {
+ content: attr(data-value)
+}
+
+pre .conum[data-value] {
+ position: relative;
+ top: -.125em
+}
+
+b.conum * {
+ color: inherit !important
+}
+
+.conum:not([data-value]):empty {
+ display: none
+}
+
+dt,
+th.tableblock,
+td.content,
+div.footnote {
+ text-rendering: optimizeLegibility
+}
+
+h1,
+h2,
+p,
+td.content,
+span.alt {
+ letter-spacing: -.01em
+}
+
+p strong,
+td.content strong,
+div.footnote strong {
+ letter-spacing: -.005em
+}
+
+p,
+blockquote,
+dt,
+td.content,
+span.alt {
+ /*font-size: 1.0625rem*/
+}
+
+p {
+ margin-bottom: 1.25rem
+}
+
+.sidebarblock p,
+.sidebarblock dt,
+.sidebarblock td.content,
+p.tableblock {
+ font-size: 1em
+}
+
+.exampleblock>.content {
+ background-color: #fffef7;
+ border-color: #dddddd;
+ -webkit-box-shadow: 0 1px 4px #e0e0dc;
+ box-shadow: 0 1px 4px #e0e0dc
+}
+
+.print-only {
+ display: none !important
+}
+
+@page {
+ margin: 1.25cm .75cm
+}
+
+@media print {
+ * {
+ -webkit-box-shadow: none !important;
+ box-shadow: none !important;
+ text-shadow: none !important
+ }
+
+ html {
+ font-size: 80%
+ }
+
+ a {
+ color: inherit !important;
+ text-decoration: underline !important
+ }
+
+ a.bare,
+ a[href^="#"],
+ a[href^="mailto:"] {
+ text-decoration: none !important
+ }
+
+ a[href^="http:"]:not(.bare)::after,
+ a[href^="https:"]:not(.bare)::after {
+ content: "("attr(href) ")";
+ display: inline-block;
+ font-size: .875em;
+ padding-left: .25em
+ }
+
+ abbr[title]::after {
+ content: " ("attr(title) ")"
+ }
+
+ pre,
+ blockquote,
+ tr,
+ img,
+ object,
+ svg {
+ page-break-inside: avoid
+ }
+
+ thead {
+ display: table-header-group
+ }
+
+ svg {
+ max-width: 100%
+ }
+
+ p,
+ blockquote,
+ dt,
+ td.content {
+ font-size: 1em;
+ orphans: 3;
+ widows: 3
+ }
+
+ h2,
+ h3,
+ #toctitle,
+ .sidebarblock>.content>.title {
+ page-break-after: avoid
+ }
+
+ #toc,
+ .sidebarblock,
+ .exampleblock>.content {
+ background: none !important
+ }
+
+ #toc {
+ border-bottom: 1px solid #dddddd !important;
+ padding-bottom: 0 !important
+ }
+
+ body.book #header {
+ text-align: center
+ }
+
+ body.book #header>h1:first-child {
+ border: 0 !important;
+ margin: 2.5em 0 1em
+ }
+
+ body.book #header .details {
+ border: 0 !important;
+ display: block;
+ padding: 0 !important
+ }
+
+ body.book #header .details span:first-child {
+ margin-left: 0 !important
+ }
+
+ body.book #header .details br {
+ display: block
+ }
+
+ body.book #header .details br+span::before {
+ content: none !important
+ }
+
+ body.book #toc {
+ border: 0 !important;
+ text-align: left !important;
+ padding: 0 !important;
+ margin: 0 !important
+ }
+
+ body.book #toc,
+ body.book #preamble,
+ body.book h1.sect0,
+ body.book .sect1>h2 {
+ page-break-before: always
+ }
+
+ .listingblock code[data-lang]::before {
+ display: block
+ }
+
+ #footer {
+ padding: 0 .9375em
+ }
+
+ .hide-on-print {
+ display: none !important
+ }
+
+ .print-only {
+ display: block !important
+ }
+
+ .hide-for-print {
+ display: none !important
+ }
+
+ .show-for-print {
+ display: inherit !important
+ }
+
+}
+
+@media print, amzn-kf8 {
+ #header>h1:first-child {
+ margin-top: 1.25rem
+ }
+
+ .sect1 {
+ padding: 0 !important
+ }
+
+ .sect1+.sect1 {
+ border: 0
+ }
+
+ #footer {
+ background: none
+ }
+
+ #footer-text {
+ color: rgba(0, 0, 0, .6);
+ font-size: .9em
+ }
+
+}
+
+@media amzn-kf8 {
+ #header,
+ #content,
+ #footnotes,
+ #footer {
+ padding: 0
+ }
+
+}
+</style>
+<style>
+/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
+/*pre.CodeRay {background-color:#f7f7f8;}*/
+.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
+.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
+.CodeRay .line-numbers strong{color:rgba(0,0,0,.4)}
+table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
+table.CodeRay td{vertical-align: top;line-height:1.45}
+table.CodeRay td.line-numbers{text-align:right}
+table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
+table.CodeRay td.code{padding:0 0 0 .5em}
+table.CodeRay td.code>pre{padding:0}
+.CodeRay .debug{color:#fff !important;background:#000080 !important}
+.CodeRay .annotation{color:#007}
+.CodeRay .attribute-name{color:#000080}
+.CodeRay .attribute-value{color:#700}
+.CodeRay .binary{color:#509}
+.CodeRay .comment{color:#998;font-style:italic}
+.CodeRay .char{color:#04d}
+.CodeRay .char .content{color:#04d}
+.CodeRay .char .delimiter{color:#039}
+.CodeRay .class{color:#458;font-weight:bold}
+.CodeRay .complex{color:#a08}
+.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
+.CodeRay .color{color:#099}
+.CodeRay .class-variable{color:#369}
+.CodeRay .decorator{color:#b0b}
+.CodeRay .definition{color:#099}
+.CodeRay .delimiter{color:#000}
+.CodeRay .doc{color:#970}
+.CodeRay .doctype{color:#34b}
+.CodeRay .doc-string{color:#d42}
+.CodeRay .escape{color:#666}
+.CodeRay .entity{color:#800}
+.CodeRay .error{color:#808}
+.CodeRay .exception{color:inherit}
+.CodeRay .filename{color:#099}
+.CodeRay .function{color:#900;font-weight:bold}
+.CodeRay .global-variable{color:#008080}
+.CodeRay .hex{color:#058}
+.CodeRay .integer,.CodeRay .float{color:#099}
+.CodeRay .include{color:#555}
+.CodeRay .inline{color:#000}
+.CodeRay .inline .inline{background:#ccc}
+.CodeRay .inline .inline .inline{background:#bbb}
+.CodeRay .inline .inline-delimiter{color:#d14}
+.CodeRay .inline-delimiter{color:#d14}
+.CodeRay .important{color:#555;font-weight:bold}
+.CodeRay .interpreted{color:#b2b}
+.CodeRay .instance-variable{color:#008080}
+.CodeRay .label{color:#970}
+.CodeRay .local-variable{color:#963}
+.CodeRay .octal{color:#40e}
+.CodeRay .predefined{color:#369}
+.CodeRay .preprocessor{color:#579}
+.CodeRay .pseudo-class{color:#555}
+.CodeRay .directive{font-weight:bold}
+.CodeRay .type{font-weight:bold}
+.CodeRay .predefined-type{color:inherit}
+.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
+.CodeRay .key{color:#808}
+.CodeRay .key .delimiter{color:#606}
+.CodeRay .key .char{color:#80f}
+.CodeRay .value{color:#088}
+.CodeRay .regexp .delimiter{color:#808}
+.CodeRay .regexp .content{color:#808}
+.CodeRay .regexp .modifier{color:#808}
+.CodeRay .regexp .char{color:#d14}
+.CodeRay .regexp .function{color:#404;font-weight:bold}
+.CodeRay .string{color:#d20}
+.CodeRay .string .string .string{background:#ffd0d0}
+.CodeRay .string .content{color:#d14}
+.CodeRay .string .char{color:#d14}
+.CodeRay .string .delimiter{color:#d14}
+.CodeRay .shell{color:#d14}
+.CodeRay .shell .delimiter{color:#d14}
+.CodeRay .symbol{color:#990073}
+.CodeRay .symbol .content{color:#a60}
+.CodeRay .symbol .delimiter{color:#630}
+.CodeRay .tag{color:#008080}
+.CodeRay .tag-special{color:#d70}
+.CodeRay .variable{color:#036}
+.CodeRay .insert{background:#afa}
+.CodeRay .delete{background:#faa}
+.CodeRay .change{color:#aaf;background:#007}
+.CodeRay .head{color:#f8f;background:#505}
+.CodeRay .insert .insert{color:#080}
+.CodeRay .delete .delete{color:#800}
+.CodeRay .change .change{color:#66f}
+.CodeRay .head .head{color:#f4f}
+</style>
+</head>
+<body class="article">
+<div id="header">
+<div id="toc" class="toc">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel3">
+<li><a href="#_installation">Installation</a></li>
+<li><a href="#_repositories">Repositories</a></li>
+<li><a href="#_creating_repository_and_repository_details">Creating repository and repository details</a></li>
+<li><a href="#_listing_repositories">Listing repositories</a></li>
+<li><a href="#_changing_repository_settings">Changing repository settings</a></li>
+<li><a href="#_upload_artifacts">Upload artifacts</a></li>
+<li><a href="#_delete_artifacts">Delete artifacts</a></li>
+<li><a href="#_copy_repositories_content">Copy repositories content</a></li>
+<li><a href="#_proxy_and_mirror">Proxy and mirror</a></li>
+<li><a href="#_osgi_bundle_repository">OSGi Bundle Repository</a></li>
+<li><a href="#_purge">Purge</a></li>
+<li><a href="#_remove">Remove</a></li>
+<li><a href="#_repository_scheduler">Repository Scheduler</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div class="paragraph">
+<p>Cave Repositories Manager is a simple but complete artifacts repository manager. You can create repositories used
+to store artifact.
+The repositories are Maven and OSGi Bundle Repository compliant. A repository doesn’t necessary store the artifacts, it
+can also serve as proxy or mirror to other remote repositories.</p>
+</div>
+<div class="sect3">
+<h4 id="_installation">Installation</h4>
+<div class="paragraph">
+<p>The first step is to register Cave features repository XML in a running Karaf instance:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> features:repo-add cave 4.2.0</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Once it’s done, you can install the <code>cave-repository</code> feature:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> feature:install cave-repository</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The Cave Repository Manager service providing:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>shell commands to manipulate the repositories</p>
+</li>
+<li>
+<p>MBean to manipulate the repositories via JMX</p>
+</li>
+<li>
+<p>REST API to manipulate the repositories with REST client (like <code>curl</code> for instance)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_repositories">Repositories</h4>
+<div class="paragraph">
+<p>A Cave repository is a artifact storage that clients can use (download or uploading artifacts).</p>
+</div>
+<div class="paragraph">
+<p>Repositories are managed by a <code>RepositoryService</code> and each repository has:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>name</code> is unique in the repository service.</p>
+</li>
+<li>
+<p><code>location</code> is where the artifacts are actually stored on the filesystem (it can be null if the repository is a proxy).</p>
+</li>
+<li>
+<p><code>url</code> is the HTTP location where the repository is accessible remotely.</p>
+</li>
+<li>
+<p><code>proxy</code> is a list of remote repositories that a repository can proxy.</p>
+</li>
+<li>
+<p><code>mirror</code> is a boolean used when the repository is a proxy. If <code>true</code>, when a client download an artifact from the repository, the artifact is download on remote repositories and cached on local repository storage. If <code>false</code>, the artifact is not cached on local repository storage.</p>
+</li>
+<li>
+<p><code>realm</code> is a JAAS security realm used to secure the users able to download/upload artifacts on the repository.</p>
+</li>
+<li>
+<p><code>download role</code> is the user role (on the realm) to secure artifacts download operation.</p>
+</li>
+<li>
+<p><code>scheduling</code> is the scheduler configuration (cron or date) to trigger an action on the repository. For instance <code>cron:0/20 * * * * ?</code> with execute action on the repository every 20 seconds.</p>
+</li>
+<li>
+<p><code>schedulingAction</code> is the action when scheduler is triggered. Possible actions are <code>PURGE</code>, <code>DELETE</code>, <code>COPY targetRepositoryName</code> and can be combined (comma separated). For instance: <code>PURGE,DELETE</code>.</p>
+</li>
+<li>
+<p><code>upload role</code> is the user role (on the realm) to secure artifacts upload operation.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_creating_repository_and_repository_details">Creating repository and repository details</h4>
+<div class="sect4">
+<h5 id="_code_cave_repository_create_code_and_code_cave_repository_info_code_shell_commands"><code>cave:repository-create</code> and <code>cave:repository-info</code> shell commands</h5>
+<div class="paragraph">
+<p>You can simply create a repository with the <code>cave:repository-create</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-create myrepo</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By the default, <code>myrepo</code> repository has the following setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>myrepo</code> <code>location</code> is set to <code>${KARAF_DATA}/cave/repository/myrepo</code>. It can be changed at repository creation or later using <code>cave:repository-location</code> command (see later).</p>
+</li>
+<li>
+<p><code>myrepo</code> <code>url</code> is set to <code>/cave/repository/myrepo</code> (based on the Apache Karaf HTTP service). It can be changed at repository creation or later using <code>cave:repository-url</code> command (see later).</p>
+</li>
+<li>
+<p><code>myrepo</code> <code>proxy</code> is empty as, by default, repositories are "concrete" repository (with storage).</p>
+</li>
+<li>
+<p><code>myrepo</code> <code>realm</code> is <code>karaf</code> by default. It means that you can use roles defined in the <code>karaf</code> JAAS realm. You can take a look on the security and JAAS section of the Apache Karaf user guide for details.</p>
+</li>
+<li>
+<p><code>myrepo</code> <code>downloadRole</code> is empty, meaning that anyone can download artifacts from this repository.</p>
+</li>
+<li>
+<p><code>myrepo</code> <code>uploadRole</code> is empty, meaning that anyone can upload artifacts to this repository.</p>
+</li>
+<li>
+<p><code>myrepo</code> <code>scheduling</code> is empty, meaning no scheduler.</p>
+</li>
+<li>
+<p><code>myrepo</code> <code>schedulingAction</code> is empty, meaning no scheduler.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The <code>cave:repository-create</code> command provides the options allowing you to specify repository settings:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>DESCRIPTION
+ cave:repository-create
+
+ Create a new repository
+
+SYNTAX
+ cave:repository-create [options] name
+
+ARGUMENTS
+ name
+ The repository name
+ (required)
+
+OPTIONS
+ -m, --mirror
+ Enable repository mirror mode (for proxy)
+ -sa, --scheduling-action, --action, --actions
+ The repository scheduling action (DELETE, PURGE, COPY)
+ --help
+ Display this help message
+ -dr, --download-role
+ The repository security download role
+ -r, --realm
+ The repository security realm
+ (defaults to karaf)
+ -ur, --upload-role
+ The repository security upload role
+ -p, --proxy
+ The repository proxy locations
+ -l, --location
+ The repository location
+ -u, --url
+ The repository URL
+ -ps, --pool-size
+ The repository pool size for the HTTP service
+ (defaults to 8)
+ -s, --scheduling, --schedule
+ The repository scheduling (cron: or at:)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can have details about existing repository using <code>cave:repository-info</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-info myrepo
+Name: myrepo
+Location: /opt/karaf/data/cave/repository/myrepo
+URL: /cave/repository/myrepo
+Proxy:
+Mirror: false
+Realm: karaf
+Download role:
+Upload role:
+Scheduling:
+Scheduling Actions:
+Pool size: 8</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can use "regular" Apache Karaf commands related to the services used by the repository.</p>
+</div>
+<div class="paragraph">
+<p>For instance, you can see the repository HTTP binding using <code>http:list</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> http:list
+ID â Servlet â Servlet-Name â State â Alias â Url
+âââââ¼ââââââââââââââââââââââââ¼âââââââââââââââââââââââââââââ¼ââââââââââââââ¼ââââââââââââââââââââââââââ¼âââââââââââââââââ
+102 â CXFNonSpringServlet â cxf-osgi-transport-servlet â Deployed â /cxf â [/cxf/*]
+116 â MavenServlet â ServletModel-2 â Deployed â /cave/repository/myrepo â [/cave/repository/myrepo/*]
+116 â RepositoryRestServlet â ServletModel-4 â Deployed â /cave/repository/api â [/cave/repository/api/*]</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NB: <code>/cave/repository/api</code> URL is the default REST API repository service.</p>
+</div>
+<div class="paragraph">
+<p>It means, using your Internet browser, you can browse <code>myrepo</code> on <code><a href="http://localhost:8181/cave/repository/myrepo/" class="bare">http://localhost:8181/cave/repository/myrepo/</a></code>.</p>
+</div>
+<div class="paragraph">
+<p>You can also see the realm and login modules with corresponding <code>jaas:realm-list</code> command.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api">REST API</h5>
+<div class="paragraph">
+<p>It’s also possible to create a repository using the REST API. You can find the WADL of the REST API on <code>/cave/repository/api?_wadl</code> URL.</p>
+</div>
+<div class="paragraph">
+<p>For instance, you can create a repository using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X POST -H "Content-Type: application/json" http://localhost:8181/cave/repository/api/repositories -d '{ "name":"myrepo", "location": "", "url": "", "proxy":"", "mirror": false,"realm":"karaf","downloadRole":"","uploadRole":"","poolSize":8}'</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also have details about a repository using the REST API. For instance, using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X GET http://localhost:8181/cave/repository/api/repositories/myrepo
+{"name":"myrepo","location":"/opt/karaf/data/cave/repository/myrepo","url":"/cave/repository/myrepo","proxy":null,"mirror":false,"realm":"karaf","downloadRole":null,"uploadRole":null,"poolSize":8}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean">JMX MBean</h5>
+<div class="paragraph">
+<p>You can also create a repository using the <code>create(String name)</code> or <code>create(String name, String location, String url, String proxy, boolean mirror, String realm, String downloadRole, String uploadRole, int poolSize)</code> operations on the <code>org.apache.karaf.cave:type=repository</code> MBean.</p>
+</div>
+<div class="paragraph">
+<p>On the <code>Repositories</code> attribute on the <code>org.apache.karaf.cave:type=repository</code> MBean, you can get all details about any repository.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service">Service</h5>
+<div class="paragraph">
+<p>You can also create a repository programmatically using <code>create(String name)</code> or <code>create(String name, String location, String url, String proxy, boolean mirror, String realm, String downloadRole, String uploadRole, int poolSize)</code> methods on the <code>org.apache.karaf.cave.repository.RepositoryService</code>.</p>
+</div>
+<div class="paragraph">
+<p>You just have to look for the <code>RepositoryService</code> in the Karaf service registry. For instance using DS programming model, you can do:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>@Reference
+private org.apache.karaf.cave.repository.RepositoryService repositoryService;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_listing_repositories">Listing repositories</h4>
+<div class="sect4">
+<h5 id="_code_cave_repository_list_code_shell_command"><code>cave:repository-list</code> shell command</h5>
+<div class="paragraph">
+<p>You can list all repositories using the <code>cave:repository-list</code> shell command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-list
+Name â Location â URL
+ââââââââ¼âââââââââââââââââââââââââââââââââââââââââ¼ââââââââââââââââââââââââ
+myrepo â /opt/karaf/data/cave/repository/myrepo â /cave/repository/myrepo</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_2">REST API</h5>
+<div class="paragraph">
+<p>You can get the list of all repositories via the Cave Repository REST API using GET method on <code>/cave/repository/api/repositories</code>. For instance using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X GET http://localhost:8181/cave/repository/api/repositories
+[{"name":"myrepo","location":"/home/jbonofre/Downloads/apache-karaf-4.2.7/data/cave/repository/myrepo","url":"/cave/repository/myrepo","proxy":null,"mirror":false,"realm":"karaf","downloadRole":null,"uploadRole":null,"poolSize":8}]</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_2">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>repositories</code> attribute on the <code>org.apache.karaf.cave:type=repository</code> MBean provides a tabular data with all repositories.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_2">Service</h5>
+<div class="paragraph">
+<p>On the <code>org.apache.karaf.cave.repository.RepositoryService</code>, you can programmatically get <code>org.apache.karaf.cave.repository.Repository</code> collection using <code>repositories()</code> method.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_changing_repository_settings">Changing repository settings</h4>
+<div class="paragraph">
+<p>You can change repository settings after it has been created using dedicated operation.</p>
+</div>
+<div class="sect4">
+<h5 id="_code_cave_repository_url_code_code_cave_repository_proxy_code_code_cave_repository_location_code_code_cave_repository_security_code_shell_commands"><code>cave:repository-url</code>, <code>cave:repository-proxy</code>, <code>cave:repository-location</code>, <code>cave:repository-security</code> shell commands</h5>
+<div class="paragraph">
+<p>You can see or change the repository location using <code>cave:repository-location</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-location myrepo
+/opt/karaf/data/cave/repository/myrepo
+karaf@root()> cave:repository-location myrepo /path/to/foo
+/path/to/foo</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NB: The repository service will then move the repository location filesystem to the new location.</p>
+</div>
+<div class="paragraph">
+<p>You can see or change the repository binding HTTP URL using <code>cave:repository-url</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-url myrepo
+/cave/repository/myrepo
+karaf@root()> cave:repository-url myrepo /foo
+/foo</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NB: The repository service will stop the repository HTTP service to start a new one on the new URL.</p>
+</div>
+<div class="paragraph">
+<p>You can see or change the repository proxy settings using <code>cave:repository-proxy</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-proxy myrepo
+null
+karaf@root()> cave:repository-proxy -m myrepo http://repo1.maven.org/maven2@id=central
+http://repo1.maven.org/maven2@id=central (mirror)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NB: When change the proxy settings, the repository location is not changed.</p>
+</div>
+<div class="paragraph">
+<p>You can see or change the repository security settings using <code>cave:repository-security</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-security myrepo
+Realm: karaf
+Download Role: null
+Upload Role: null
+karaf@root()> cave:repository-security -ur admin myrepo karaf
+Realm: karaf
+Download Role: null
+Upload Role: admin</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NB: The repository service will restart the repository HTTP service with the new security settings.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_3">REST API</h5>
+<div class="paragraph">
+<p>You can use <code>/cave/repository/api/repositories/myrepo</code> URL with a updated repository json to update the repository settings. For instance using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X POST -H "Content-Type: application/json" http://localhost:8181/cave/repository/api/repositories/myrepo -d '{ "name":"myrepo", "location": "", "url": "", "proxy":"", "mirror": false,"realm":"karaf","downloadRole":"","uploadRole":"","poolSize":8}'</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_3">JMX MBean</h5>
+<div class="paragraph">
+<p>You have dedicated operations on <code>org.apache.karaf.cave:type=repository</code> MBean to change repository settings:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>changeLocation(String repositoryName, String newLocation)</code> to change the location of a repository. The repository service will actually move the location filesystem.</p>
+</li>
+<li>
+<p><code>changeUrl(String repositoryName, String new URL)</code> to change the URL of a repository. The repository service will stop the previous HTTP repository service to crerate start a new one.</p>
+</li>
+<li>
+<p><code>changeProxy(String repositoryName, String proxy, boolean mirror)</code> to change the proxy settings (URLs and mirror mode). The repository location is not changed.</p>
+</li>
+<li>
+<p><code>changeSecurity(String repositoryName, String realm, String downloadRole, String uploadRole)</code> to change the security settings (realm, download, and upload roles). The repository HTTP service will be restarted with the new security settings.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_3">Service</h5>
+<div class="paragraph">
+<p>On the <code>org.apache.karaf.cave.repository.RepositoryService</code>, you have the following methods to change repository settings:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>changeLocation(String repositoryName, String newLocation)</code> to change the location of a repository. The repository service will actually move the location filesystem.</p>
+</li>
+<li>
+<p><code>changeUrl(String repositoryName, String new URL)</code> to change the URL of a repository. The repository service will stop the previous HTTP repository service to crerate start a new one.</p>
+</li>
+<li>
+<p><code>changeProxy(String repositoryName, String proxy, boolean mirror)</code> to change the proxy settings (URLs and mirror mode). The repository location is not changed.</p>
+</li>
+<li>
+<p><code>changeSecurity(String repositoryName, String realm, String downloadRole, String uploadRole)</code> to change the security settings (realm, download, and upload roles). The repository HTTP service will be restarted with the new security settings.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_upload_artifacts">Upload artifacts</h4>
+<div class="paragraph">
+<p>You can upload artifacts in a repository using a regular HTTP client (via <code>curl</code> for instance).</p>
+</div>
+<div class="paragraph">
+<p>You can also directly use Maven (in your project using <code>distributionManagement</code> in the <code>pom.xml</code>) or Gradle.
+With Maven, you can also using <code>deploy:deploy-file</code> goal:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>mvn deploy:deploy-file -Dfile=my.jar -Durl=http://localhost:8181/cave/repository/myrepo -DgroupId=foo -DartifactId=bar -Dversion=1.0-SNAPSHOT -Dpackaging=jar</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_code_cave_repository_artifact_add_code_shell_command"><code>cave:repository-artifact-add</code> shell command</h5>
+<div class="paragraph">
+<p>For convenience, Cave Repository provides <code>cave:repository-artifact-add</code> command to upload artifact in a repository:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-artifact-add myrepo mvn:commons-lang/commons-lang/2.6</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_4">REST API</h5>
+<div class="paragraph">
+<p>You can upload an artifact using the Cave Repository REST API via <code>/cave/repository/api/repositories/myrepo/artifact</code> URL and providing the artifact URL as header:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X POST -H "artifactUrl: mvn:commons-lang/commons-lang/2.6" http://localhost:8181/cave/repository/api/repositories/myrepo/artifact</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_4">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave:type=repository</code> MBean provides the <code>addArtifact(String repositoryName, String artifactUrl)</code> operation allowing you to add an artifact in a repository.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_4">Service</h5>
+<div class="paragraph">
+<p>You can programmatically add artifact in a repository using <code>org.apache.karaf.cave.repository.RepositoryService</code> and the <code>addArtifact(String repositoryName, String artifactUrl)</code> method.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_delete_artifacts">Delete artifacts</h4>
+<div class="sect4">
+<h5 id="_code_cave_repository_artifact_delete_code_shell_command"><code>cave:repository-artifact-delete</code> shell command</h5>
+<div class="paragraph">
+<p>The <code>cave:repository-artifact-delete</code> shell command allows you to delete an artifact from a repository:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-artifact-delete myrepo mvn:commons-lang/commons-lang/2.6</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_5">REST API</h5>
+<div class="paragraph">
+<p>You can delete an artifact from a repository using the Cave Repository REST API via <code>/cave/repository/api/repositories/myrepo/artifact</code> URL and providing the artifact URL as header:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X DELETE -H "artifactUrl: mvn:commons-lang/commons-lang/2.6" http://localhost:8181/cave/repository/api/repositories/myrepo/artifact</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_5">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave:type=repository</code> MBean provides the <code>deleteArtifact(String repositoryName, String artifactUrl)</code> operation allowing you to delete an artifact in a repository.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_5">Service</h5>
+<div class="paragraph">
+<p>You can programmatically delete artifact in a repository using <code>org.apache.karaf.cave.repository.RepositoryService</code> and the <code>addArtifact(String repositoryName, String artifactUrl)</code> method.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_copy_repositories_content">Copy repositories content</h4>
+<div class="paragraph">
+<p>You can copy the whole content of a repository location into another repository location (it’s a full recursive copy).</p>
+</div>
+<div class="sect4">
+<h5 id="_code_cave_repository_copy_code_shell_command"><code>cave:repository-copy</code> shell command</h5>
+<div class="paragraph">
+<p>The <code>cave:repository-copy</code> shell command copies the whole content of a source repository to a destination repository:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-copy myrepo anotherrepo</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_6">REST API</h5>
+<div class="paragraph">
+<p>Copy is not allowed on the Cave Repository REST API.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_6">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave:type=repository</code> MBean provides the <code>copy(String sourceRepository, String destinationRepository)</code> operation.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_6">Service</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave.repository.RepositoryService</code> service provides <code>copy(String sourceRepository, String destinationRepository)</code> method.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_proxy_and_mirror">Proxy and mirror</h4>
+<div class="paragraph">
+<p>A repository can proxy other repositories. The client (for instance Maven) request an artifact on the repository which "proxy" the request to other repositories define.</p>
+</div>
+<div class="paragraph">
+<p>If the mirror mode is enabled, the artifacts are copied into the repository storage location in addition of being delivered to the client (it’s kind of artifacts caching).
+If the mirror mode is disabled, the repository storage is not used at all, and the artifact is passed directly.</p>
+</div>
+<div class="paragraph">
+<p>The proxy setting define the list of remote repositories (separated with coma). In addition, you can use <code>@id=</code> to give a name to the remote repository (just like in the <code>settings.xml</code>, but this is optional but recommended), <code>@snapshots</code> to indicate the remote repository can contains SNAPSHOT artifacts, <code>@noreleases</code> to indicate the remote repository doesn’t only contains release artifacts.</p>
+</div>
+<div class="paragraph">
+<p>For instance, you can proxy Maven Central with the following command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-create -p http://repo1.maven.org/maven2@id=central myrepo
+karaf@root()> cave:repository-info myrepo
+Name: myrepo
+Location: null
+URL: /cave/repository/myrepo
+Proxy: http://repo1.maven.org/maven2@id=central
+Mirror: false
+Realm: karaf
+Download role:
+Upload role:
+Pool size: 8</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Now, let’s request an artifact on <code>myrepo</code> repository using <code><a href="http://localhost:8181/cave/repository/myrepo/commons-lang/commons-lang/2.6/commons-lang-2.6.jar" class="bare">http://localhost:8181/cave/repository/myrepo/commons-lang/commons-lang/2.6/commons-lang-2.6.jar</a></code> (remember <code>myrepo</code> is empty and doesn’t have any location):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -O http://localhost:8181/cave/repository/myrepo/commons-lang/commons-lang/2.6/commons-lang-2.6.jar
+ % Total % Received % Xferd Average Speed Time Time Time Current
+ Dload Upload Total Spent Left Speed
+100 277k 100 277k 0 0 16.9M 0 --:--:-- --:--:-- --:--:-- 16.9M</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>We can see here, <code>myrepo</code> has correctly proxy the request to Maven Central.</p>
+</div>
+<div class="paragraph">
+<p>Now, let’s add a location and enable <code>mirror</code> on <code>myrepo</code> repository:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-location myrepo /tmp
+karaf@root()> cave:repository-proxy -m myrepo http://repo1.apache.org/maven2@id=Central
+karaf@root()> cave:repository-info myrepo
+Name: myrepo
+Location: /tmp
+URL: /cave/repository/myrepo
+Proxy: http://repo1.apache.org/maven2@id=Central
+Mirror: true
+Realm: karaf
+Download role:
+Upload role:
+Scheduling:
+Scheduling Actions:
+Pool size: 8</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>And now, we perform the same request using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -O http://localhost:8181/cave/repository/myrepo/commons-lang/commons-lang/2.6/commons-lang-2.6.jar
+ % Total % Received % Xferd Average Speed Time Time Time Current
+ Dload Upload Total Spent Left Speed
+100 277k 100 277k 0 0 16.9M 0 --:--:-- --:--:-- --:--:-- 16.9M</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Now, if we check in the <code>myrepo</code> storage location (that we defined to <code>/tmp</code>), we can see the "cached" artifact:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>ls -ltr /tmp/commons-lang/commons-lang/2.6/commons-lang-2.6.jar
+-rw-r--r-- 1 karaf karaf 284220 oct. 13 10:56 /tmp/commons-lang/commons-lang/2.6/commons-lang-2.6.jar</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_osgi_bundle_repository">OSGi Bundle Repository</h4>
+<div class="paragraph">
+<p>Cave Repository supports OSGi Bundle Repository descriptor generation (aka <code>repository.xml</code>).</p>
+</div>
+<div class="paragraph">
+<p>It can scan all artifacts in a repository to generate the <code>repository.xml</code>.</p>
+</div>
+<div class="sect4">
+<h5 id="_code_cave_repository_update_bundle_descriptor_code_shell_command"><code>cave:repository-update-bundle-descriptor</code> shell command</h5>
+<div class="paragraph">
+<p>The <code>cave:repository-update-bundle-descriptor</code> shell command trigger the scan of all artifacts in a repository to generate a <code>repository.xml</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-update-bundle-descriptor myrepo</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>We now have a <code>repository.xml</code> generated (or updated) in the repository storage location. Of course, it’s also available via HTTP on <code><a href="http://localhost:8181/cave/repository/myrepo/repository.xml" class="bare">http://localhost:8181/cave/repository/myrepo/repository.xml</a></code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_7">REST API</h5>
+<div class="paragraph">
+<p>You can trigger <code>repository.xml</code> update via the Cave Repository REST API on <code>/cave/repository/api/repositories/myrepo/bundle</code>. For instance using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X POST http://localhost:8181/cave/repository/api/repositories/myrepo/bundle</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_7">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave:type=repository</code> MBean provides the <code>updateBundleRepositoryDescriptor(String repositoryName)</code> operation to update the OSGi Bundle Repository <code>repository.xml</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_7">Service</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave.repository.RepositoryService</code> service provides the <code>updateBundleRepositoryDescriptor(String name)</code> method to update the OSGi Bundle Repository <code>repository.xml</code>.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_purge">Purge</h4>
+<div class="paragraph">
+<p>You can completely purge a repository store, removing all artifacts.</p>
+</div>
+<div class="sect4">
+<h5 id="_code_cave_repository_purge_code_shell_command"><code>cave:repository-purge</code> shell command</h5>
+<div class="paragraph">
+<p>You can cleanup completely a repository storage location using <code>cave:repository-purge</code> command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-purge myrepo</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NB: you will have an error if the repository doesn’t have any storage location defined, for instance when the repository is only a proxy.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_8">REST API</h5>
+<div class="paragraph">
+<p>You can cleanup completely a repository storage using <code>/cave/repository/api/repositories/myrepo/purge</code> URL (POST). For instance, using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl X POST http://localhost:8181/cave/repository/api/repositories/myrepo/purge</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_8">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave:type=repository</code> MBean provides the <code>purge(String repositoryName)</code> operation to trigger a repository location purge.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_8">Service</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave.repository.RepositoryService</code> service provides the <code>purge(String repositoryName)</code> method to trigger a repository location purge.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_remove">Remove</h4>
+<div class="paragraph">
+<p>You can completely remove a repository from the Cave Repository Service (by default, the repository storage is not deleted). Optionally, you can also purge the storage location.</p>
+</div>
+<div class="sect4">
+<h5 id="_code_cave_repository_remove_code_shell_command"><code>cave:repository-remove</code> shell command</h5>
+<div class="paragraph">
+<p>The <code>cave:repository-remove</code> shell command removes a repository, optionally (using <code>-p, --purge</code> option) removing the repository storage:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-remove -p myrepo</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rest_api_9">REST API</h5>
+<div class="paragraph">
+<p>You can delete a repository using <code>/cave/repository/api/repositories/myrepo</code> (DELETE). For instance, using <code>curl</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>curl -X DELETE http://localhost:8181/cave/repository/api/repositories/myrepo</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NB: it’s not possible to purge the repository storage when removing the repository via the REST API. You have first to purge the repository location before removing the repository.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_9">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave;type=repository</code> MBean provides the <code>remove(String repositoryName, boolean purgeLocation)</code> operation to remove a repository. If <code>purgeLocation</code> is true, the repository storage will be cleanup, <code>false</code> else.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_9">Service</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave.repository.RepositoryService</code> service provides the <code>remove(String repositoryName, boolean purgeLocation)</code> method to remove a repository. If <code>purgeLocation</code> is true, the repository storage will be cleanup, <code>false</code> else.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_repository_scheduler">Repository Scheduler</h4>
+<div class="paragraph">
+<p>You can trigger action on a repository using Cave Scheduling feature.</p>
+</div>
+<div class="paragraph">
+<p>The repository scheduling supports cron (to periodically perform actions) or date (to execute actions at a specific time). For instance, you can perform actions every 5 seconds using <code>cron:0/5 * * * * ?</code> as repository scheduling.
+You can also execute actions at a certain date using <code>at:2020-05-13T13:56:45</code>.</p>
+</div>
+<div class="paragraph">
+<p>The valid repository scheduling actions are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>PURGE</code> to cleanup the repository storage location.</p>
+</li>
+<li>
+<p><code>DELETE</code> to remove the repository.</p>
+</li>
+<li>
+<p><code>COPY targetRepositoryName</code> to copy all artifacts from the repository storage to another repository.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The actions can be combined (comma separated). For instance, you can copy and purge using <code>COPY myrepo,PURGE</code> or purge and remove using <code>PURGE,DELETE</code>, etc.</p>
+</div>
+<div class="paragraph">
+<p>The repository scheduling and actions can be defined at repository creation time (using <code>-s</code> and <code>-sa</code> options on <code>cave:repository-create</code> shell command for instance), or later.</p>
+</div>
+<div class="sect4">
+<h5 id="_code_cave_repository_schedule_code_shell_command"><code>cave:repository-schedule</code> shell command</h5>
+<div class="paragraph">
+<p>The <code>cave:repository-schedule</code> shell command displays or set the current repository scheduling.</p>
+</div>
+<div class="paragraph">
+<p>For instance, you can set the scheduling using:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code>karaf@root()> cave:repository-schedule myrepo "cron:0/20 * * * * ?" "COPY destination"</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_jmx_mbean_10">JMX MBean</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave:type=repository</code> MBean provides the <code>changeScheduling(String name, String scheduling, String actions)</code> operation to change the repository scheduling.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_service_10">Service</h5>
+<div class="paragraph">
+<p>The <code>org.apache.karaf.cave.repository.RepositoryService</code> service provides the <code>changeScheduling(String name, String scheduling, String schedulingAction)</code> method to change the repository scheduling.</p>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Last updated 2019-10-22 18:53:03 CEST
+</div>
+</div>
+</body>
+</html>
\ No newline at end of file