build based on 95555df

This commit is contained in:
zeptodoctor 2018-12-19 20:43:38 +00:00
parent 237c2ad80d
commit 6a10068dd0
15 changed files with 1687 additions and 2 deletions

2
stable
View File

@ -1 +1 @@
v0.4.0
v0.4.1

2
v0.4
View File

@ -1 +1 @@
v0.4.0
v0.4.1

63
v0.4.1/assets/arrow.svg Normal file
View File

@ -0,0 +1,63 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="16.5mm"
height="8.6603003mm"
viewBox="0 0 58.464567 30.686103"
id="svg2"
version="1.1"
inkscape:version="0.91 r13725"
sodipodi:docname="arrow.svg">
<defs
id="defs4" />
<sodipodi:namedview
id="base"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:pageopacity="0.0"
inkscape:pageshadow="2"
inkscape:zoom="11.2"
inkscape:cx="14.209234"
inkscape:cy="29.780479"
inkscape:document-units="px"
inkscape:current-layer="layer1"
showgrid="false"
inkscape:window-width="1920"
inkscape:window-height="1053"
inkscape:window-x="0"
inkscape:window-y="27"
inkscape:window-maximized="1" />
<metadata
id="metadata7">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<g
inkscape:label="Layer 1"
inkscape:groupmode="layer"
id="layer1"
transform="translate(0,-1021.6761)">
<path
style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
d="m 0,1021.6761 35.433071,0 -17.716536,30.6861 z"
id="path4140"
inkscape:connector-curvature="0"
sodipodi:nodetypes="cccc" />
</g>
</svg>

After

Width:  |  Height:  |  Size: 1.9 KiB

View File

@ -0,0 +1,601 @@
/*
* The default CSS style for Documenter.jl generated sites
*
* Heavily inspired by the Julia Sphinx theme
* https://github.com/JuliaLang/JuliaDoc
* which extends the sphinx_rtd_theme
* https://github.com/snide/sphinx_rtd_theme
*
* Part of Documenter.jl
* https://github.com/JuliaDocs/Documenter.jl
*
* License: MIT
*/
/* fonts */
body, input {
font-family: 'Lato', 'Helvetica Neue', Arial, sans-serif;
font-size: 16px;
color: #222;
text-rendering: optimizeLegibility;
}
pre, code, kbd {
font-family: 'Roboto Mono', Monaco, courier, monospace;
font-size: 0.90em;
}
pre code {
font-size: 1em;
}
a {
color: #2980b9;
text-decoration: none;
}
a:hover {
color: #3091d1;
}
a:visited {
color: #9b59b6;
}
body {
line-height: 1.5;
}
h1 {
font-size: 1.75em;
}
/* Unless the <h1> the is very first thing on the page (i.e. the second element
* in the <article>, * after the <header>, we add some additional styling to it
* to make it stand out a bit more. This way we get a reasonable fallback if CSS3
* selectors are not supported in the browser.
*/
article > h1:not(:nth-child(2)) {
margin: 2.5em 0 0;
padding-bottom: 0.30em;
border-bottom: 1px solid #e5e5e5;
}
h2 {
font-size: 1.50em;
margin: 2.3em 0 0;
padding-bottom: 0.25em;
border-bottom: 1px solid #e5e5e5;
}
h3 {
font-size: 1.25em;
margin: 2.0em 0 0;
}
h4 { font-size: 1.15em; }
h5 { font-size: 1.10em; }
h6 { font-size: 1em; }
h4, h5, h6 {
margin-top: 1.5em;
margin-bottom: 1em;
}
img {
max-width: 100%;
}
table {
border-collapse: collapse;
margin: 1em 0;
}
th, td {
border: 1px solid #e1e4e5;
padding: 0.5em 1em;
}
th {
border-bottom-width: 2px;
}
tr:nth-child(even) {
background-color: #f3f6f6;
}
hr {
border: 0;
border-top: 1px solid #e5e5e5;
}
/* Inline code and code blocks */
code {
padding: 0.1em;
background-color: rgba(0,0,0,.04);
border-radius: 3px;
}
pre {
background-color: #f5f5f5;
border: 1px solid #dddddd;
border-radius: 3px;
padding: 0.5em;
overflow: auto;
}
pre code {
padding: 0;
background-color: initial;
}
kbd {
font-size: 0.70em;
display: inline-block;
padding: 0.1em 0.5em 0.4em 0.5em;
line-height: 1.0em;
color: #444d56;
vertical-align: middle;
background-color: #fafbfc;
border: solid 1px #c6cbd1;
border-bottom-color: #959da5;
border-radius: 3px;
box-shadow: inset 0 -1px 0 #959da5;
}
/* Headers in admonitions and docstrings */
.admonition h1,
article section.docstring h1 {
font-size: 1.25em;
}
.admonition h2,
article section.docstring h2 {
font-size: 1.10em;
}
.admonition h3,
.admonition h4,
.admonition h5,
.admonition h6,
article section.docstring h3,
article section.docstring h4,
article section.docstring h5,
article section.docstring h6 {
font-size: 1em;
}
/* Navigation */
nav.toc {
position: fixed;
top: 0;
left: 0;
bottom: 0;
width: 20em;
display: flex;
flex-flow: column nowrap;
overflow-y: auto;
padding: 1em 0 0 0;
background-color: #fcfcfc;
box-shadow: inset -14px 0px 5px -12px rgb(210,210,210);
}
nav.toc .logo {
margin: 0 auto;
display: block;
max-height: 6em;
max-width: 18em;
}
nav.toc h1 {
text-align: center;
margin-top: .57em;
margin-bottom: 0;
}
nav.toc select {
display: block;
height: 2em;
flex-shrink: 0;
padding: 0 1.6em 0 1em;
min-width: 7em;
max-width: 90%;
max-width: calc(100% - 5em);
margin: 0 auto;
font-size: .83em;
border: 1px solid #c9c9c9;
border-radius: 1em;
/* TODO: doesn't seem to be centered on Safari */
text-align: center;
text-align-last: center;
appearance: none;
-moz-appearance: none;
-webkit-appearance: none;
background: white url("arrow.svg");
background-size: 1.155em;
background-repeat: no-repeat;
background-position: right;
}
nav.toc select:hover {
border: 1px solid #a0a0a0;
}
nav.toc select option {
text-align: center;
}
nav.toc input {
display: block;
height: 2em;
width: 90%;
width: calc(100% - 5em);
margin: 1.2em auto;
padding: 0 1em;
border: 1px solid #c9c9c9;
border-radius: 1em;
font-size: .83em;
}
nav.toc > ul * {
margin: 0;
}
nav.toc > ul {
min-height: 2em;
overflow-y: auto;
margin: 0;
}
nav.toc > ul > li:last-child {
padding-bottom: 1em;
}
nav.toc ul {
color: #404040;
padding: 0;
list-style: none;
}
nav.toc ul .toctext {
color: inherit;
display: block;
}
nav.toc ul a:hover {
color: #fcfcfc;
background-color: #4e4a4a;
}
nav.toc ul.internal a {
color: inherit;
display: block;
}
nav.toc ul.internal a:hover {
background-color: #d6d6d6;
}
nav.toc ul.internal {
background-color: #e3e3e3;
box-shadow: inset -14px 0px 5px -12px rgb(210,210,210);
list-style: none;
}
nav.toc ul.internal li.toplevel {
border-top: 1px solid #909090;
font-weight: bold;
}
nav.toc ul.internal li.toplevel:first-child {
border-top: none;
}
nav.toc .toctext {
padding-top: 0.3em;
padding-bottom: 0.3em;
padding-right: 1em;
}
nav.toc ul .toctext {
padding-left: 1em;
}
nav.toc ul ul .toctext {
padding-left: 2em;
}
nav.toc ul ul ul .toctext {
padding-left: 3em;
}
nav.toc li.current > .toctext {
border-top: 1px solid #c9c9c9;
border-bottom: 1px solid #c9c9c9;
color: #404040;
font-weight: bold;
background-color: white;
}
nav.toc ul::-webkit-scrollbar {
width: .4em;
background: none;
}
nav.toc ul::-webkit-scrollbar-thumb {
border-radius: 5px;
background: #c9c9c9;
}
nav.toc ul::-webkit-scrollbar-thumb:hover {
border-radius: 5px;
background: #aaaaaa;
}
article {
margin-left: 20em;
min-width: 20em;
max-width: 48em;
padding: 2em;
}
article > header {}
article > header div#topbar {
display: none;
}
article > header nav ul {
display: inline-block;
list-style: none;
margin: 0;
padding: 0;
}
article > header nav li {
display: inline-block;
padding-right: 0.2em;
}
article > header nav li:before {
content: "»";
padding-right: 0.2em;
}
article > header .edit-page {
float: right;
}
article > footer {}
article > footer a.prev {
float: left;
}
article > footer a.next {
float: right;
}
article > footer a .direction:after {
content: ": ";
}
article hr {
margin: 1em 0;
}
article section.docstring {
border: 1px solid #ddd;
margin: 0.5em 0;
padding: 0.5em;
border-radius: 3px;
}
article section.docstring .docstring-header {
margin-bottom: 1em;
}
article section.docstring .docstring-binding {
color: #333;
font-weight: bold;
}
article section.docstring .docstring-category {
font-style: italic;
}
article section.docstring a.source-link {
display: block;
font-weight: bold;
}
.nav-anchor,
.nav-anchor:hover,
.nav-anchor:visited {
color: #333;
}
/*
* Admonitions
*
* Colors (title, body)
* warning: #f0b37e #ffedcc (orange)
* note: #6ab0de #e7f2fa (blue)
* tip: #1abc9c #dbfaf4 (green)
*/
.admonition {
border-radius: 3px;
background-color: #eeeeee;
margin: 1em 0;
}
.admonition-title {
border-radius: 3px 3px 0 0;
background-color: #9b9b9b;
padding: 0.15em 0.5em;
}
.admonition-text {
padding: 0.5em;
}
.admonition-text > :first-child {
margin-top: 0;
}
.admonition-text > :last-child {
margin-bottom: 0;
}
.admonition > .admonition-title:before {
font-family: "FontAwesome";
margin-right: 5px;
content: "\f06a";
}
.admonition.warning > .admonition-title {
background-color: #f0b37e;
}
.admonition.warning {
background-color: #ffedcc;
}
.admonition.note > .admonition-title {
background-color: #6ab0de;
}
.admonition.note {
background-color: #e7f2fa;
}
.admonition.tip > .admonition-title {
background-color: #1abc9c;
}
.admonition.tip {
background-color: #dbfaf4;
}
/* footnotes */
.footnote {
padding-left: 0.8em;
border-left: 2px solid #ccc;
}
/* Search page */
#search-results .category {
font-size: smaller;
}
/* Overriding the <code> block style of highligh.js.
* We have to override the padding and the background-color, since we style this
* part ourselves. Specifically, we style the <pre> surrounding the <code>, while
* highlight.js applies the .hljs style directly to the <code> tag.
*/
.hljs {
background-color: transparent;
padding: 0;
}
@media only screen and (max-width: 768px) {
nav.toc {
position: fixed;
width: 16em;
left: -16em;
-webkit-overflow-scrolling: touch;
-webkit-transition-property: left; /* Safari */
-webkit-transition-duration: 0.3s; /* Safari */
transition-property: left;
transition-duration: 0.3s;
-webkit-transition-timing-function: ease-out; /* Safari */
transition-timing-function: ease-out;
z-index: 2;
box-shadow: 5px 0px 5px 0px rgb(210,210,210);
}
nav.toc.show {
left: 0;
}
article {
margin-left: 0;
padding: 3em 0.9em 0 0.9em; /* top right bottom left */
overflow-wrap: break-word;
}
article > header {
position: fixed;
left: 0;
z-index: 1;
}
article > header nav, hr {
display: none;
}
article > header div#topbar {
display: block; /* is mobile */
position: fixed;
width: 100%;
height: 1.5em;
padding-top: 1em;
padding-bottom: 1em;
background-color: #fcfcfc;
box-shadow: 0 1px 3px rgba(0,0,0,.26);
top: 0;
-webkit-transition-property: top; /* Safari */
-webkit-transition-duration: 0.3s; /* Safari */
transition-property: top;
transition-duration: 0.3s;
}
article > header div#topbar.headroom--unpinned.headroom--not-top.headroom--not-bottom {
top: -4em;
-webkit-transition-property: top; /* Safari */
-webkit-transition-duration: 0.7s; /* Safari */
transition-property: top;
transition-duration: 0.7s;
}
article > header div#topbar span {
width: 80%;
height: 1.5em;
margin-top: -0.1em;
margin-left: 0.9em;
font-size: 1.2em;
overflow: hidden;
}
article > header div#topbar a.fa-bars {
float: right;
padding: 0.6em;
margin-top: -0.6em;
margin-right: 0.3em;
font-size: 1.5em;
}
article > header div#topbar a.fa-bars:visited {
color: #3091d1;
}
article table {
overflow-x: auto;
display: block;
}
article div.MathJax_Display {
overflow: scroll;
}
article span.MathJax {
overflow: hidden;
}
}
@media only screen and (max-width: 320px) {
body {
font-size: 15px;
}
}

132
v0.4.1/assets/documenter.js Normal file
View File

@ -0,0 +1,132 @@
/*
* Part of Documenter.jl
* https://github.com/JuliaDocs/Documenter.jl
*
* License: MIT
*/
requirejs.config({
paths: {
'jquery': 'https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.min',
'jqueryui': 'https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.12.0/jquery-ui.min',
'headroom': 'https://cdnjs.cloudflare.com/ajax/libs/headroom/0.9.3/headroom.min',
'mathjax': 'https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS_HTML',
'highlight': 'https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min',
'highlight-julia': 'https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/julia.min',
'highlight-julia-repl': 'https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/julia-repl.min',
},
shim: {
'mathjax' : {
exports: "MathJax"
},
'highlight-julia': ['highlight'],
'highlight-julia-repl': ['highlight'],
}
});
// Load MathJax
require(['mathjax'], function(MathJax) {
MathJax.Hub.Config({
"tex2jax": {
inlineMath: [['$','$'], ['\\(','\\)']],
processEscapes: true
}
});
MathJax.Hub.Config({
config: ["MMLorHTML.js"],
jax: [
"input/TeX",
"output/HTML-CSS",
"output/NativeMML"
],
extensions: [
"MathMenu.js",
"MathZoom.js",
"TeX/AMSmath.js",
"TeX/AMSsymbols.js",
"TeX/autobold.js",
"TeX/autoload-all.js"
]
});
MathJax.Hub.Config({
TeX: { equationNumbers: { autoNumber: "AMS" } }
});
})
require(['jquery', 'highlight', 'highlight-julia', 'highlight-julia-repl'], function($, hljs) {
$(document).ready(function() {
hljs.initHighlighting();
})
})
// update the version selector with info from the siteinfo.js and ../versions.js files
require(['jquery'], function($) {
$(document).ready(function() {
var version_selector = $("#version-selector");
// add the current version to the selector based on siteinfo.js, but only if the selector is empty
if (typeof DOCUMENTER_CURRENT_VERSION !== 'undefined' && $('#version-selector > option').length == 0) {
var option = $("<option value='#' selected='selected'>" + DOCUMENTER_CURRENT_VERSION + "</option>");
version_selector.append(option);
}
if (typeof DOC_VERSIONS !== 'undefined') {
var existing_versions = $('#version-selector > option');
var existing_versions_texts = existing_versions.map(function(i,x){return x.text});
DOC_VERSIONS.forEach(function(each) {
var version_url = documenterBaseURL + "/../" + each;
var existing_id = $.inArray(each, existing_versions_texts);
// if not already in the version selector, add it as a new option,
// otherwise update the old option with the URL and enable it
if (existing_id == -1) {
var option = $("<option value='" + version_url + "'>" + each + "</option>");
version_selector.append(option);
} else {
var option = existing_versions[existing_id];
option.value = version_url;
option.disabled = false;
}
});
}
// only show the version selector if the selector has been populated
if ($('#version-selector > option').length > 0) {
version_selector.css("visibility", "visible");
}
// Scroll the navigation bar to the currently selected menu item
$("nav.toc > ul").get(0).scrollTop = $(".current").get(0).offsetTop - $("nav.toc > ul").get(0).offsetTop;
})
})
// mobile
require(['jquery', 'headroom'], function($, Headroom) {
$(document).ready(function() {
var navtoc = $("nav.toc");
$("nav.toc li.current a.toctext").click(function() {
navtoc.toggleClass('show');
});
$("article > header div#topbar a.fa-bars").click(function(ev) {
ev.preventDefault();
navtoc.toggleClass('show');
if (navtoc.hasClass('show')) {
var title = $("article > header div#topbar span").text();
$("nav.toc ul li a:contains('" + title + "')").focus();
}
});
$("article#docs").bind('click', function(ev) {
if ($(ev.target).is('div#topbar a.fa-bars')) {
return;
}
if (navtoc.hasClass('show')) {
navtoc.removeClass('show');
}
});
if ($("article > header div#topbar").css('display') == 'block') {
var headroom = new Headroom(document.querySelector("article > header div#topbar"), {"tolerance": {"up": 10, "down": 10}});
headroom.init();
}
})
})

250
v0.4.1/assets/search.js Normal file
View File

@ -0,0 +1,250 @@
/*
* Part of Documenter.jl
* https://github.com/JuliaDocs/Documenter.jl
*
* License: MIT
*/
// parseUri 1.2.2
// (c) Steven Levithan <stevenlevithan.com>
// MIT License
function parseUri (str) {
var o = parseUri.options,
m = o.parser[o.strictMode ? "strict" : "loose"].exec(str),
uri = {},
i = 14;
while (i--) uri[o.key[i]] = m[i] || "";
uri[o.q.name] = {};
uri[o.key[12]].replace(o.q.parser, function ($0, $1, $2) {
if ($1) uri[o.q.name][$1] = $2;
});
return uri;
};
parseUri.options = {
strictMode: false,
key: ["source","protocol","authority","userInfo","user","password","host","port","relative","path","directory","file","query","anchor"],
q: {
name: "queryKey",
parser: /(?:^|&)([^&=]*)=?([^&]*)/g
},
parser: {
strict: /^(?:([^:\/?#]+):)?(?:\/\/((?:(([^:@]*)(?::([^:@]*))?)?@)?([^:\/?#]*)(?::(\d*))?))?((((?:[^?#\/]*\/)*)([^?#]*))(?:\?([^#]*))?(?:#(.*))?)/,
loose: /^(?:(?![^:@]+:[^:@\/]*@)([^:\/?#.]+):)?(?:\/\/)?((?:(([^:@]*)(?::([^:@]*))?)?@)?([^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/
}
};
requirejs.config({
paths: {
'jquery': 'https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.min',
'lunr': 'https://cdnjs.cloudflare.com/ajax/libs/lunr.js/2.3.1/lunr.min',
'lodash': 'https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.17.4/lodash.min',
}
});
var currentScript = document.currentScript;
require(["jquery", "lunr", "lodash"], function($, lunr, _) {
$("#search-form").submit(function(e) {
e.preventDefault()
})
// list below is the lunr 2.1.3 list minus the intersect with names(Base)
// (all, any, get, in, is, which) and (do, else, for, let, where, while, with)
// ideally we'd just filter the original list but it's not available as a variable
lunr.stopWordFilter = lunr.generateStopWordFilter([
'a',
'able',
'about',
'across',
'after',
'almost',
'also',
'am',
'among',
'an',
'and',
'are',
'as',
'at',
'be',
'because',
'been',
'but',
'by',
'can',
'cannot',
'could',
'dear',
'did',
'does',
'either',
'ever',
'every',
'from',
'got',
'had',
'has',
'have',
'he',
'her',
'hers',
'him',
'his',
'how',
'however',
'i',
'if',
'into',
'it',
'its',
'just',
'least',
'like',
'likely',
'may',
'me',
'might',
'most',
'must',
'my',
'neither',
'no',
'nor',
'not',
'of',
'off',
'often',
'on',
'only',
'or',
'other',
'our',
'own',
'rather',
'said',
'say',
'says',
'she',
'should',
'since',
'so',
'some',
'than',
'that',
'the',
'their',
'them',
'then',
'there',
'these',
'they',
'this',
'tis',
'to',
'too',
'twas',
'us',
'wants',
'was',
'we',
'were',
'what',
'when',
'who',
'whom',
'why',
'will',
'would',
'yet',
'you',
'your'
])
// add . as a separator, because otherwise "title": "Documenter.Anchors.add!"
// would not find anything if searching for "add!", only for the entire qualification
lunr.tokenizer.separator = /[\s\-\.]+/
// custom trimmer that doesn't strip @ and !, which are used in julia macro and function names
lunr.trimmer = function (token) {
return token.update(function (s) {
return s.replace(/^[^a-zA-Z0-9@!]+/, '').replace(/[^a-zA-Z0-9@!]+$/, '')
})
}
lunr.Pipeline.registerFunction(lunr.stopWordFilter, 'juliaStopWordFilter')
lunr.Pipeline.registerFunction(lunr.trimmer, 'juliaTrimmer')
var index = lunr(function () {
this.ref('location')
this.field('title')
this.field('text')
documenterSearchIndex['docs'].forEach(function(e) {
this.add(e)
}, this)
})
var store = {}
documenterSearchIndex['docs'].forEach(function(e) {
store[e.location] = {title: e.title, category: e.category}
})
$(function(){
function update_search(querystring) {
tokens = lunr.tokenizer(querystring)
results = index.query(function (q) {
tokens.forEach(function (t) {
q.term(t.toString(), {
fields: ["title"],
boost: 100,
usePipeline: false,
editDistance: 0,
wildcard: lunr.Query.wildcard.NONE
})
q.term(t.toString(), {
fields: ["title"],
boost: 10,
usePipeline: false,
editDistance: 2,
wildcard: lunr.Query.wildcard.NONE
})
q.term(t.toString(), {
fields: ["text"],
boost: 1,
usePipeline: true,
editDistance: 0,
wildcard: lunr.Query.wildcard.NONE
})
})
})
$('#search-info').text("Number of results: " + results.length)
$('#search-results').empty()
results.forEach(function(result) {
data = store[result.ref]
link = $('<a>')
link.text(data.title)
link.attr('href', documenterBaseURL+'/'+result.ref)
cat = $('<span class="category">('+data.category+')</span>')
li = $('<li>').append(link).append(" ").append(cat)
$('#search-results').append(li)
})
}
function update_search_box() {
querystring = $('#search-query').val()
update_search(querystring)
}
$('#search-query').keyup(_.debounce(update_search_box, 250))
$('#search-query').change(update_search_box)
search_query_uri = parseUri(window.location).queryKey["q"]
if(search_query_uri !== undefined) {
search_query = decodeURIComponent(search_query_uri.replace(/\+/g, '%20'))
$("#search-query").val(search_query)
}
update_search_box();
})
})

38
v0.4.1/index.html Normal file
View File

@ -0,0 +1,38 @@
<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Home · PkgTemplates.jl</title><link href="https://cdnjs.cloudflare.com/ajax/libs/normalize/4.2.0/normalize.min.css" rel="stylesheet" type="text/css"/><link href="https://fonts.googleapis.com/css?family=Lato|Roboto+Mono" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" rel="stylesheet" type="text/css"/><script>documenterBaseURL="."</script><script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.2.0/require.min.js" data-main="assets/documenter.js"></script><script src="siteinfo.js"></script><script src="../versions.js"></script><link href="assets/documenter.css" rel="stylesheet" type="text/css"/></head><body><nav class="toc"><h1>PkgTemplates.jl</h1><select id="version-selector" onChange="window.location.href=this.value" style="visibility: hidden"></select><form class="search" id="search-form" action="search/"><input id="search-query" name="q" type="text" placeholder="Search docs"/></form><ul><li class="current"><a class="toctext" href>Home</a><ul class="internal"><li><a class="toctext" href="#Installation-1">Installation</a></li><li><a class="toctext" href="#Usage-1">Usage</a></li><li><a class="toctext" href="#Comparison-to-PkgDev-1">Comparison to PkgDev</a></li><li><a class="toctext" href="#Contributing-1">Contributing</a></li></ul></li><li><a class="toctext" href="pages/package_generation/">Package Generation</a></li><li><a class="toctext" href="pages/plugins/">Plugins</a></li><li><a class="toctext" href="pages/plugin_development/">Plugin Development</a></li><li><a class="toctext" href="pages/licenses/">Licenses</a></li><li><a class="toctext" href="pages/">Index</a></li></ul></nav><article id="docs"><header><nav><ul><li><a href>Home</a></li></ul><a class="edit-page" href="https://github.com/invenia/PkgTemplates.jl/blob/master/docs/src/index.md#L"><span class="fa"></span> Edit on GitHub</a></nav><hr/><div id="topbar"><span>Home</span><a class="fa fa-bars" href="#"></a></div></header><h1><a class="nav-anchor" id="PkgTemplates-1" href="#PkgTemplates-1">PkgTemplates</a></h1><p><a href="https://invenia.github.io/PkgTemplates.jl/stable"><img src="https://img.shields.io/badge/docs-stable-blue.svg" alt="Stable"/></a> <a href="https://invenia.github.io/PkgTemplates.jl/latest"><img src="https://img.shields.io/badge/docs-latest-blue.svg" alt="Latest"/></a> <a href="https://travis-ci.org/invenia/PkgTemplates.jl"><img src="https://travis-ci.org/invenia/PkgTemplates.jl.svg?branch=master" alt="Build Status"/></a> <a href="https://ci.appveyor.com/project/christopher-dG/pkgtemplates-jl/branch/master"><img src="https://ci.appveyor.com/api/projects/status/r24xamruqlm88uti/branch/master?svg=true" alt="Build Status"/></a> <a href="https://codecov.io/gh/invenia/PkgTemplates.jl"><img src="https://codecov.io/gh/invenia/PkgTemplates.jl/branch/master/graph/badge.svg" alt="Codecov"/></a></p><p><strong>PkgTemplates is a Julia package for creating new Julia packages in an easy, repeatable, and customizable way.</strong></p><h2><a class="nav-anchor" id="Installation-1" href="#Installation-1">Installation</a></h2><pre><code class="language-julia">pkg&gt; add PkgTemplates</code></pre><h2><a class="nav-anchor" id="Usage-1" href="#Usage-1">Usage</a></h2><div></div><p>The simplest template requires no arguments.</p><pre><code class="language-julia-repl">julia&gt; using PkgTemplates
ERROR: ArgumentError: Package PkgTemplates not found in current path:
- Run `import Pkg; Pkg.add(&quot;PkgTemplates&quot;)` to install the PkgTemplates package.
julia&gt; t = Template()
ERROR: UndefVarError: Template not defined
julia&gt; generate(&quot;MyPkg&quot;, t)
ERROR: UndefVarError: generate not defined
julia&gt; run(`git -C $(joinpath(t.dir, &quot;MyPkg&quot;)) ls-files`);
ERROR: UndefVarError: t not defined</code></pre><p>However, we can also configure a number of keyword arguments to <a href="pages/package_generation/#PkgTemplates.Template"><code>Template</code></a>:</p><pre><code class="language-julia-repl">julia&gt; using PkgTemplates
ERROR: ArgumentError: Package PkgTemplates not found in current path:
- Run `import Pkg; Pkg.add(&quot;PkgTemplates&quot;)` to install the PkgTemplates package.
julia&gt; t = Template(;
user=&quot;myusername&quot;,
license=&quot;MIT&quot;,
authors=[&quot;Chris de Graaf&quot;, &quot;Invenia Technical Computing Corporation&quot;],
dir=&quot;~/code&quot;,
julia_version=v&quot;0.7&quot;,
ssh=true,
plugins=[
TravisCI(),
Codecov(),
Coveralls(),
AppVeyor(),
GitHubPages(),
],
)
ERROR: UndefVarError: TravisCI not defined
julia&gt; generate(&quot;MyPkg2&quot;, t)
ERROR: UndefVarError: generate not defined
julia&gt; run(`git -C $(joinpath(t.dir, &quot;MyPkg2&quot;)) ls-files`);
ERROR: UndefVarError: t not defined</code></pre><p>If that looks like a lot of work, you can also create templates interactively with <a href="pages/package_generation/#PkgTemplates.interactive_template"><code>interactive_template</code></a>:</p><p><a href="https://asciinema.org/a/31bZqW9u8h5RHpd7gtsemioRV"><img src="https://asciinema.org/a/31bZqW9u8h5RHpd7gtsemioRV.png" alt="asciicast"/></a></p><p>And if that&#39;s <strong>still</strong> too much work for you, you can call <code>interactive_template</code> with <code>fast=true</code> to use default values for everything but username and plugin selection.</p><p>You can also use <a href="pages/package_generation/#PkgTemplates.generate_interactive"><code>generate_interactive</code></a> to interactively generate a template and then immediately use it to create a new package.</p><h2><a class="nav-anchor" id="Comparison-to-PkgDev-1" href="#Comparison-to-PkgDev-1">Comparison to PkgDev</a></h2><p><code>PkgTemplates</code> is similar in functionality to <a href="https://github.com/JuliaLang/PkgDev.jl"><code>PkgDev</code></a>&#39;s <code>generate</code> function. However, <code>PkgTemplates</code> offers more customizability in templates and more extensibility via plugins. For the package registration and release management features that <code>PkgTemplates</code> doesn&#39;t include, you are encouraged to use <a href="https://github.com/apps/attobot">AttoBot</a> instead.</p><h2><a class="nav-anchor" id="Contributing-1" href="#Contributing-1">Contributing</a></h2><p>It&#39;s extremely easy to extend <code>PkgTemplates</code> with new plugins. To get started, check out the <a href="https://invenia.github.io/PkgTemplates.jl/stable/pages/plugin_development.html">plugin development guide</a>.</p><footer><hr/><a class="next" href="pages/package_generation/"><span class="direction">Next</span><span class="title">Package Generation</span></a></footer></article></body></html>

2
v0.4.1/pages/index.html Normal file

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1,2 @@
<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Licenses · PkgTemplates.jl</title><link href="https://cdnjs.cloudflare.com/ajax/libs/normalize/4.2.0/normalize.min.css" rel="stylesheet" type="text/css"/><link href="https://fonts.googleapis.com/css?family=Lato|Roboto+Mono" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" rel="stylesheet" type="text/css"/><script>documenterBaseURL="../.."</script><script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.2.0/require.min.js" data-main="../../assets/documenter.js"></script><script src="../../siteinfo.js"></script><script src="../../../versions.js"></script><link href="../../assets/documenter.css" rel="stylesheet" type="text/css"/></head><body><nav class="toc"><h1>PkgTemplates.jl</h1><select id="version-selector" onChange="window.location.href=this.value" style="visibility: hidden"></select><form class="search" id="search-form" action="../../search/"><input id="search-query" name="q" type="text" placeholder="Search docs"/></form><ul><li><a class="toctext" href="../../">Home</a></li><li><a class="toctext" href="../package_generation/">Package Generation</a></li><li><a class="toctext" href="../plugins/">Plugins</a></li><li><a class="toctext" href="../plugin_development/">Plugin Development</a></li><li class="current"><a class="toctext" href>Licenses</a><ul class="internal"></ul></li><li><a class="toctext" href="../">Index</a></li></ul></nav><article id="docs"><header><nav><ul><li><a href>Licenses</a></li></ul><a class="edit-page" href="https://github.com/invenia/PkgTemplates.jl/blob/master/docs/src/pages/licenses.md#L"><span class="fa"></span> Edit on GitHub</a></nav><hr/><div id="topbar"><span>Licenses</span><a class="fa fa-bars" href="#"></a></div></header><h1><a class="nav-anchor" id="Licenses-1" href="#Licenses-1">Licenses</a></h1><p><a href="https://github.com/christopher-dG/PkgTemplates.jl/tree/master/licenses">Many open-source licenses</a> are available for use with <code>PkgTemplates</code>, but if you see that one is missing, don&#39;t hesitate to open an issue or PR.</p><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="PkgTemplates.available_licenses" href="#PkgTemplates.available_licenses"><code>PkgTemplates.available_licenses</code></a><span class="docstring-category">Function</span>.</div><div><div><pre><code class="language-none">available_licenses([io::IO]) -&gt; Nothing</code></pre><p>Print the names of all available licenses.</p></div></div><a class="source-link" target="_blank" href="https://github.com/invenia/PkgTemplates.jl/blob/95555df86feaea2dc7371475d716a7a9710817e8/src/licenses.jl#LL14-L18">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="PkgTemplates.show_license" href="#PkgTemplates.show_license"><code>PkgTemplates.show_license</code></a><span class="docstring-category">Function</span>.</div><div><div><pre><code class="language-none">show_license([io::IO], license::AbstractString) -&gt; Nothing</code></pre><p>Print the text of <code>license</code>. Errors if the license is not found.</p></div></div><a class="source-link" target="_blank" href="https://github.com/invenia/PkgTemplates.jl/blob/95555df86feaea2dc7371475d716a7a9710817e8/src/licenses.jl#LL22-L26">source</a></section><h3><a class="nav-anchor" id="Helper-Functions-1" href="#Helper-Functions-1">Helper Functions</a></h3><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="PkgTemplates.read_license" href="#PkgTemplates.read_license"><code>PkgTemplates.read_license</code></a><span class="docstring-category">Function</span>.</div><div><div><pre><code class="language-none">read_license(license::AbstractString) -&gt; String</code></pre><p>Returns the contents of <code>license</code>. Errors if the license is not found. Use <a href="#PkgTemplates.available_licenses"><code>available_licenses</code></a> to view available licenses.</p></div></div><a class="source-link" target="_blank" href="https://github.com/invenia/PkgTemplates.jl/blob/95555df86feaea2dc7371475d716a7a9710817e8/src/licenses.jl#LL30-L35">source</a></section><footer><hr/><a class="previous" href="../plugin_development/"><span class="direction">Previous</span><span class="title">Plugin Development</span></a><a class="next" href="../"><span class="direction">Next</span><span class="title">Index</span></a></footer></article></body></html>

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

2
v0.4.1/search/index.html Normal file
View File

@ -0,0 +1,2 @@
<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Search · PkgTemplates.jl</title><link href="https://cdnjs.cloudflare.com/ajax/libs/normalize/4.2.0/normalize.min.css" rel="stylesheet" type="text/css"/><link href="https://fonts.googleapis.com/css?family=Lato|Roboto+Mono" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" rel="stylesheet" type="text/css"/><script>documenterBaseURL=".."</script><script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.2.0/require.min.js" data-main="../assets/documenter.js"></script><script src="../siteinfo.js"></script><script src="../../versions.js"></script><link href="../assets/documenter.css" rel="stylesheet" type="text/css"/></head><body><nav class="toc"><h1>PkgTemplates.jl</h1><select id="version-selector" onChange="window.location.href=this.value" style="visibility: hidden"></select><form class="search" id="search-form" action><input id="search-query" name="q" type="text" placeholder="Search docs"/></form><ul><li><a class="toctext" href="../">Home</a></li><li><a class="toctext" href="../pages/package_generation/">Package Generation</a></li><li><a class="toctext" href="../pages/plugins/">Plugins</a></li><li><a class="toctext" href="../pages/plugin_development/">Plugin Development</a></li><li><a class="toctext" href="../pages/licenses/">Licenses</a></li><li><a class="toctext" href="../pages/">Index</a></li></ul></nav><article><header><nav><ul><li>Search</li></ul></nav><hr/><div id="topbar"><span>Search</span><a class="fa fa-bars" href="#"></a></div></header><h1>Search</h1><p id="search-info">Number of results: <span id="search-results-number">loading...</span></p><ul id="search-results"></ul></article></body><script src="../search_index.js"></script><script src="../assets/search.js"></script></html>

515
v0.4.1/search_index.js Normal file
View File

@ -0,0 +1,515 @@
var documenterSearchIndex = {"docs": [
{
"location": "#",
"page": "Home",
"title": "Home",
"category": "page",
"text": ""
},
{
"location": "#PkgTemplates-1",
"page": "Home",
"title": "PkgTemplates",
"category": "section",
"text": "(Image: Stable) (Image: Latest) (Image: Build Status) (Image: Build Status) (Image: Codecov)PkgTemplates is a Julia package for creating new Julia packages in an easy, repeatable, and customizable way."
},
{
"location": "#Installation-1",
"page": "Home",
"title": "Installation",
"category": "section",
"text": "pkg> add PkgTemplates"
},
{
"location": "#Usage-1",
"page": "Home",
"title": "Usage",
"category": "section",
"text": "run(`git config --global user.name \"Travis\"`)\nrun(`git config --global user.email \"travis@c.i\"`)\nrun(`git config --global github.user \"travis\"`)\nusing Pkg\nPkg.activate(mktempdir())The simplest template requires no arguments.using PkgTemplates\nt = Template()\ngenerate(\"MyPkg\", t)\nrun(`git -C $(joinpath(t.dir, \"MyPkg\")) ls-files`);However, we can also configure a number of keyword arguments to Template:using PkgTemplates\nt = Template(;\n user=\"myusername\",\n license=\"MIT\",\n authors=[\"Chris de Graaf\", \"Invenia Technical Computing Corporation\"],\n dir=\"~/code\",\n julia_version=v\"0.7\",\n ssh=true,\n plugins=[\n TravisCI(),\n Codecov(),\n Coveralls(),\n AppVeyor(),\n GitHubPages(),\n ],\n)\ngenerate(\"MyPkg2\", t)\nrun(`git -C $(joinpath(t.dir, \"MyPkg2\")) ls-files`);If that looks like a lot of work, you can also create templates interactively with interactive_template:(Image: asciicast)And if that\'s still too much work for you, you can call interactive_template with fast=true to use default values for everything but username and plugin selection.You can also use generate_interactive to interactively generate a template and then immediately use it to create a new package."
},
{
"location": "#Comparison-to-PkgDev-1",
"page": "Home",
"title": "Comparison to PkgDev",
"category": "section",
"text": "PkgTemplates is similar in functionality to PkgDev\'s generate function. However, PkgTemplates offers more customizability in templates and more extensibility via plugins. For the package registration and release management features that PkgTemplates doesn\'t include, you are encouraged to use AttoBot instead."
},
{
"location": "#Contributing-1",
"page": "Home",
"title": "Contributing",
"category": "section",
"text": "It\'s extremely easy to extend PkgTemplates with new plugins. To get started, check out the plugin development guide."
},
{
"location": "pages/package_generation/#",
"page": "Package Generation",
"title": "Package Generation",
"category": "page",
"text": "CurrentModule = PkgTemplates"
},
{
"location": "pages/package_generation/#Package-Generation-1",
"page": "Package Generation",
"title": "Package Generation",
"category": "section",
"text": "Creating new packages with PkgTemplates revolves around creating a new Template, then calling generate on it."
},
{
"location": "pages/package_generation/#PkgTemplates.Template",
"page": "Package Generation",
"title": "PkgTemplates.Template",
"category": "type",
"text": "Template(; kwargs...) -> Template\n\nRecords common information used to generate a package. If you don\'t wish to manually create a template, you can use interactive_template instead.\n\nKeyword Arguments\n\nuser::AbstractString=\"\": GitHub (or other code hosting service) username. If left unset, it will take the the global git config\'s value (github.user). If that is not set, an ArgumentError is thrown. This is case-sensitive for some plugins, so take care to enter it correctly.\nhost::AbstractString=\"github.com\": URL to the code hosting service where your package will reside. Note that while hosts other than GitHub won\'t cause errors, they are not officially supported and they will cause certain plugins will produce incorrect output.\nlicense::AbstractString=\"MIT\": Name of the package license. If an empty string is given, no license is created. available_licenses can be used to list all available licenses, and show_license can be used to print out a particular license\'s text.\nauthors::Union{AbstractString, Vector{<:AbstractString}}=\"\": Names that appear on the license. Supply a string for one author or an array for multiple. Similarly to user, it will take the value of of the global git config\'s value if it is left unset.\ndir::AbstractString=~/.julia/dev: Directory in which the package will go. Relative paths are converted to absolute ones at template creation time.\njulia_version::VersionNumber=1.0.3: Minimum allowed Julia version.\nssh::Bool=false: Whether or not to use SSH for the remote.\nmanifest::Bool=false: Whether or not to commit the Manifest.toml.\nplugins::Vector{<:Plugin}=Plugin[]: A list of Plugins that the package will include.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#PkgTemplates.interactive_template",
"page": "Package Generation",
"title": "PkgTemplates.interactive_template",
"category": "function",
"text": "interactive_template(; fast::Bool=false) -> Template\n\nInteractively create a Template. If fast is set, defaults will be assumed for all values except username and plugins.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#Template-1",
"page": "Package Generation",
"title": "Template",
"category": "section",
"text": "Template\ninteractive_template"
},
{
"location": "pages/package_generation/#PkgTemplates.generate",
"page": "Package Generation",
"title": "PkgTemplates.generate",
"category": "function",
"text": "generate(pkg::AbstractString, t::Template) -> Nothing\ngenerate(t::Template, pkg::AbstractString) -> Nothing\n\nGenerate a package named pkg from t. If git is false, no Git repository is created.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#PkgTemplates.generate_interactive",
"page": "Package Generation",
"title": "PkgTemplates.generate_interactive",
"category": "function",
"text": "generate_interactive(pkg::AbstractString; fast::Bool=false, git::Bool=true) -> Template\n\nInteractively create a template, and then generate a package with it. Arguments and keywords are used in the same way as in generate and interactive_template.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#generate-1",
"page": "Package Generation",
"title": "generate",
"category": "section",
"text": "generate\ngenerate_interactive"
},
{
"location": "pages/package_generation/#PkgTemplates.gen_tests",
"page": "Package Generation",
"title": "PkgTemplates.gen_tests",
"category": "function",
"text": "gen_tests(pkg_dir::AbstractString, t::Template) -> Vector{String}\n\nCreate the test entrypoint in pkg_dir.\n\nArguments\n\npkg_dir::AbstractString: The package directory in which the files will be generated\nt::Template: The template whose tests we are generating.\n\nReturns an array of generated file/directory names.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#PkgTemplates.gen_require",
"page": "Package Generation",
"title": "PkgTemplates.gen_require",
"category": "function",
"text": "gen_require(pkg_dir::AbstractString, t::Template) -> Vector{String}\n\nCreate the REQUIRE file in pkg_dir.\n\nArguments\n\npkg_dir::AbstractString: The directory in which the files will be generated.\nt::Template: The template whose REQUIRE we are generating.\n\nReturns an array of generated file/directory names.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#PkgTemplates.gen_readme",
"page": "Package Generation",
"title": "PkgTemplates.gen_readme",
"category": "function",
"text": "gen_readme(pkg_dir::AbstractString, t::Template) -> Vector{String}\n\nCreate a README in pkg_dir with badges for each enabled plugin.\n\nArguments\n\npkg_dir::AbstractString: The directory in which the files will be generated.\nt::Template: The template whose README we are generating.\n\nReturns an array of generated file/directory names.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#PkgTemplates.gen_gitignore",
"page": "Package Generation",
"title": "PkgTemplates.gen_gitignore",
"category": "function",
"text": "gen_gitignore(pkg_dir::AbstractString, t::Template) -> Vector{String}\n\nCreate a .gitignore in pkg_dir.\n\nArguments\n\npkg_dir::AbstractString: The directory in which the files will be generated.\nt::Template: The template whose .gitignore we are generating.\n\nReturns an array of generated file/directory names.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#PkgTemplates.gen_license",
"page": "Package Generation",
"title": "PkgTemplates.gen_license",
"category": "function",
"text": "gen_license(pkg_dir::AbstractString, t::Template) -> Vector{String}\n\nCreate a license in pkg_dir.\n\nArguments\n\npkg_dir::AbstractString: The directory in which the files will be generated.\nt::Template: The template whose LICENSE we are generating.\n\nReturns an array of generated file/directory names.\n\n\n\n\n\n"
},
{
"location": "pages/package_generation/#Helper-Functions-1",
"page": "Package Generation",
"title": "Helper Functions",
"category": "section",
"text": "gen_tests\ngen_require\ngen_readme\ngen_gitignore\ngen_license"
},
{
"location": "pages/plugins/#",
"page": "Plugins",
"title": "Plugins",
"category": "page",
"text": "CurrentModule = PkgTemplates"
},
{
"location": "pages/plugins/#Plugins-1",
"page": "Plugins",
"title": "Plugins",
"category": "section",
"text": "Plugins are the secret sauce behind PkgTemplates\'s customization and extension. This page describes plugins that already exist; for information on writing your own plugins, see Plugin Development."
},
{
"location": "pages/plugins/#PkgTemplates.TravisCI",
"page": "Plugins",
"title": "PkgTemplates.TravisCI",
"category": "type",
"text": "TravisCI(; config_file::Union{AbstractString, Nothing}=\"\") -> TravisCI\n\nAdd TravisCI to a template\'s plugins to add a .travis.yml configuration file to generated repositories, and an appropriate badge to the README.\n\nKeyword Arguments:\n\nconfig_file::Union{AbstractString, Nothing}=\"\": Path to a custom .travis.yml. If nothing is supplied, no file will be generated.\n\n\n\n\n\n"
},
{
"location": "pages/plugins/#PkgTemplates.AppVeyor",
"page": "Plugins",
"title": "PkgTemplates.AppVeyor",
"category": "type",
"text": "AppVeyor(; config_file::Union{AbstractString, Nothing}=\"\") -> AppVeyor\n\nAdd AppVeyor to a template\'s plugins to add a .appveyor.yml configuration file to generated repositories, and an appropriate badge to the README.\n\nKeyword Arguments\n\nconfig_file::Union{AbstractString, Nothing}=\"\": Path to a custom .appveyor.yml. If nothing is supplied, no file will be generated.\n\n\n\n\n\n"
},
{
"location": "pages/plugins/#PkgTemplates.GitLabCI",
"page": "Plugins",
"title": "PkgTemplates.GitLabCI",
"category": "type",
"text": "GitLabCI(; config_file::Union{AbstractString, Nothing}=\"\", coverage::Bool=true) -> GitLabCI\n\nAdd GitLabCI to a template\'s plugins to add a .gitlab-ci.yml configuration file to generated repositories, and appropriate badge(s) to the README.\n\nKeyword Arguments:\n\nconfig_file::Union{AbstractString, Nothing}=\"\": Path to a custom .gitlab-ci.yml. If nothing is supplied, no file will be generated.\ncoverage::Bool=true: Whether or not GitLab CI\'s built-in code coverage analysis should be enabled.\n\n\n\n\n\n"
},
{
"location": "pages/plugins/#Continuous-Integration-(CI)-1",
"page": "Plugins",
"title": "Continuous Integration (CI)",
"category": "section",
"text": "TravisCI\nAppVeyor\nGitLabCI"
},
{
"location": "pages/plugins/#PkgTemplates.Codecov",
"page": "Plugins",
"title": "PkgTemplates.Codecov",
"category": "type",
"text": "Codecov(; config_file::Union{AbstractString, Nothing}=nothing) -> Codecov\n\nAdd Codecov to a template\'s plugins to optionally add a .codecov.yml configuration file to generated repositories, and an appropriate badge to the README. Also updates the .gitignore accordingly.\n\nKeyword Arguments:\n\nconfig_file::Union{AbstractString, Nothing}=nothing: Path to a custom .codecov.yml. If left unset, no file will be generated.\n\n\n\n\n\n"
},
{
"location": "pages/plugins/#PkgTemplates.Coveralls",
"page": "Plugins",
"title": "PkgTemplates.Coveralls",
"category": "type",
"text": "Coveralls(; config_file::Union{AbstractString, Nothing}=nothing) -> Coveralls\n\nAdd Coveralls to a template\'s plugins to optionally add a .coveralls.yml configuration file to generated repositories, and an appropriate badge to the README. Also updates the .gitignore accordingly.\n\nKeyword Arguments:\n\nconfig_file::Union{AbstractString, Nothing}=nothing: Path to a custom .coveralls.yml. If left unset, no file will be generated.\n\n\n\n\n\n"
},
{
"location": "pages/plugins/#Code-Coverage-1",
"page": "Plugins",
"title": "Code Coverage",
"category": "section",
"text": "Codecov\nCoveralls"
},
{
"location": "pages/plugins/#PkgTemplates.Documenter",
"page": "Plugins",
"title": "PkgTemplates.Documenter",
"category": "type",
"text": "Add a Documenter subtype to a template\'s plugins to add support for documentation generation via Documenter.jl.\n\nBy default, the plugin generates a minimal index.md and a make.jl file. The make.jl file contains the Documenter.makedocs command with predefined values for modules, format, pages, repo, sitename, and authors.\n\nThe subtype is expected to include the following fields:\n\nassets::Vector{AbstractString}, a list of filenames to be included as the assets\n\nkwarg to makedocs\n\ngitignore::Vector{AbstractString}, a list of files to be added to the .gitignore\n\nIt may optionally include the field additional_kwargs::Union{AbstractDict, NamedTuple} to allow additional kwargs to be added to makedocs.\n\n\n\n\n\n"
},
{
"location": "pages/plugins/#PkgTemplates.GitHubPages",
"page": "Plugins",
"title": "PkgTemplates.GitHubPages",
"category": "type",
"text": "GitHubPages(; assets::Vector{<:AbstractString}=String[]) -> GitHubPages\n\nAdd GitHubPages to a template\'s plugins to add Documenter support via GitHub Pages, including automatic uploading of documentation from TravisCI. Also adds appropriate badges to the README, and updates the .gitignore accordingly.\n\nKeyword Arguments\n\nassets::Vector{<:AbstractString}=String[]: Array of paths to Documenter asset files.\n\nnote: Note\nIf deploying documentation with Travis CI, don\'t forget to complete the required configuration (see here).\n\n\n\n\n\n"
},
{
"location": "pages/plugins/#Documentation-1",
"page": "Plugins",
"title": "Documentation",
"category": "section",
"text": "Documenter\nGitHubPages"
},
{
"location": "pages/plugin_development/#",
"page": "Plugin Development",
"title": "Plugin Development",
"category": "page",
"text": "CurrentModule = PkgTemplates"
},
{
"location": "pages/plugin_development/#PkgTemplates.Plugin",
"page": "Plugin Development",
"title": "PkgTemplates.Plugin",
"category": "type",
"text": "A plugin to be added to a Template, which adds some functionality or integration. New plugins should almost always extend GenericPlugin or CustomPlugin.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#Plugin-Development-1",
"page": "Plugin Development",
"title": "Plugin Development",
"category": "section",
"text": "The best and easiest way to contribute to PkgTemplates is to write new plugins.Plugin"
},
{
"location": "pages/plugin_development/#PkgTemplates.GenericPlugin",
"page": "Plugin Development",
"title": "PkgTemplates.GenericPlugin",
"category": "type",
"text": "Generic plugins are plugins that add any number of patterns to the generated package\'s .gitignore, and have at most one associated file to generate.\n\nAttributes\n\ngitignore::Vector{AbstractString}: Array of patterns to be added to the .gitignore of generated packages that use this plugin.\nsrc::Union{AbstractString, Nothing}: Path to the file that will be copied into the generated package repository. If set to nothing, no file will be generated. When this defaults to an empty string, there should be a default file in defaults that will be copied. That file\'s name is usually the same as the plugin\'s name, except in all lowercase and with the .yml extension. If this is not the case, an interactive method needs to be implemented to call interactive(; file=\"file.ext\").\ndest::AbstractString: Path to the generated file, relative to the root of the generated package repository.\nbadges::Vector{Badge}: Array of Badges containing information used to create Markdown-formatted badges from the plugin. Entries will be run through substitute, so they may contain placeholder values.\nview::Dict{String, Any}: Additional substitutions to make in both the plugin\'s badges and its associated file. See substitute for details.\n\nExample\n\n@auto_hash_equals struct MyPlugin <: GenericPlugin\n gitignore::Vector{AbstractString}\n src::Union{AbstractString, Nothing}\n dest::AbstractString\n badges::Vector{Badge}\n view::Dict{String, Any}\n\n function MyPlugin(; config_file::Union{AbstractString, Nothing}=\"\")\n if config_file != nothing\n config_file = if isempty(config_file)\n joinpath(DEFAULTS_DIR, \"my-plugin.toml\")\n elseif isfile(config_file)\n abspath(config_file)\n else\n throw(ArgumentError(\n \"File $(abspath(config_file)) does not exist\"\n ))\n end\n end\n new(\n [\"*.mgp\"],\n config_file,\n \".my-plugin.toml\",\n [\n Badge(\n \"My Plugin\",\n \"https://myplugin.com/badge-{{YEAR}}.png\",\n \"https://myplugin.com/{{USER}}/{{PKGNAME}}.jl\",\n ),\n ],\n Dict{String, Any}(\"YEAR\" => year(today())),\n )\n end\nend\n\ninteractive(::Type{MyPlugin}) = interactive(MyPlugin; file=\"my-plugin.toml\")\n\nThe above plugin ignores files ending with .mgp, copies defaults/my-plugin.toml by default, and creates a badge that links to the project on its own site, using the default substitutions with one addition: {{YEAR}} => year(today()). Since the default config template file doesn\'t follow the generic naming convention, we added another interactive method to correct the assumed filename.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#Generic-Plugins-1",
"page": "Plugin Development",
"title": "Generic Plugins",
"category": "section",
"text": "GenericPlugin"
},
{
"location": "pages/plugin_development/#PkgTemplates.CustomPlugin",
"page": "Plugin Development",
"title": "PkgTemplates.CustomPlugin",
"category": "type",
"text": "Custom plugins are plugins whose behaviour does not follow the GenericPlugin pattern. They can implement gen_plugin, badges, and interactive in any way they choose, as long as they conform to the usual type signature.\n\nAttributes\n\ngitignore::Vector{AbstractString}: Array of patterns to be added to the .gitignore of generated packages that use this plugin.\n\nExample\n\n@auto_hash_equals struct MyPlugin <: CustomPlugin\n gitignore::Vector{AbstractString}\n lucky::Bool\n\n MyPlugin() = new([], rand() > 0.8)\n\n function gen_plugin(p::MyPlugin, t::Template, pkg_name::AbstractString)\n return if p.lucky\n text = substitute(\"You got lucky with {{PKGNAME}}, {{USER}}!\", t)\n gen_file(joinpath(t.dir, pkg_name, \".myplugin.yml\"), text)\n [\".myplugin.yml\"]\n else\n println(\"Maybe next time.\")\n String[]\n end\n end\n\n function badges(p::MyPlugin, user::AbstractString, pkg_name::AbstractString)\n return if p.lucky\n [\n format(Badge(\n \"You got lucky!\",\n \"https://myplugin.com/badge.png\",\n \"https://myplugin.com/$user/$pkg_name.jl\",\n )),\n ]\n else\n String[]\n end\n end\nend\n\ninteractive(:Type{MyPlugin}) = MyPlugin()\n\nThis plugin doesn\'t do much, but it demonstrates how gen_plugin, badges and interactive can be implemented using substitute, gen_file, Badge, and format.\n\nDefining Template Files\n\nOften, the contents of the config file that your plugin generates depends on variables like the package name, the user\'s username, etc. Template files (which are stored in defaults) can use here\'s syntax to define replacements.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#Custom-Plugins-1",
"page": "Plugin Development",
"title": "Custom Plugins",
"category": "section",
"text": "CustomPlugin"
},
{
"location": "pages/plugin_development/#CustomPlugin-Required-Methods-1",
"page": "Plugin Development",
"title": "CustomPlugin Required Methods",
"category": "section",
"text": ""
},
{
"location": "pages/plugin_development/#PkgTemplates.gen_plugin",
"page": "Plugin Development",
"title": "PkgTemplates.gen_plugin",
"category": "function",
"text": "gen_plugin(p::Plugin, t::Template, pkg_name::AbstractString) -> Vector{String}\n\nGenerate any files associated with a plugin.\n\nArguments\n\np::Plugin: Plugin whose files are being generated.\nt::Template: Template configuration.\npkg_name::AbstractString: Name of the package.\n\nReturns an array of generated file/directory names.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#PkgTemplates.interactive",
"page": "Plugin Development",
"title": "PkgTemplates.interactive",
"category": "function",
"text": "interactive(T::Type{<:Plugin}; file::Union{AbstractString, Nothing}=\"\") -> Plugin\n\nInteractively create a plugin of type T, where file is the plugin type\'s default config template with a non-standard name (for MyPlugin, this is anything but \"myplugin.yml\").\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#gen_plugin-1",
"page": "Plugin Development",
"title": "gen_plugin",
"category": "section",
"text": "gen_plugin\ninteractiveNote: interactive is not strictly required, however without it, your custom plugin will not be available when creating templates with interactive_template."
},
{
"location": "pages/plugin_development/#PkgTemplates.badges",
"page": "Plugin Development",
"title": "PkgTemplates.badges",
"category": "function",
"text": "badges(p::Plugin, user::AbstractString, pkg_name::AbstractString) -> Vector{String}\n\nGenerate Markdown badges for the plugin.\n\nArguments\n\np::Plugin: Plugin whose badges we are generating.\nuser::AbstractString: Username of the package creator.\npkg_name::AbstractString: Name of the package.\n\nReturns an array of Markdown badges.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#badges-1",
"page": "Plugin Development",
"title": "badges",
"category": "section",
"text": "badges"
},
{
"location": "pages/plugin_development/#Helper-Types/Functions-1",
"page": "Plugin Development",
"title": "Helper Types/Functions",
"category": "section",
"text": ""
},
{
"location": "pages/plugin_development/#PkgTemplates.gen_file",
"page": "Plugin Development",
"title": "PkgTemplates.gen_file",
"category": "function",
"text": "gen_file(file::AbstractString, text::AbstractString) -> Int\n\nCreate a new file containing some given text. Always ends the file with a newline.\n\nArguments\n\nfile::AbstractString: Path to the file to be created.\ntext::AbstractString: Text to write to the file.\n\nReturns the number of bytes written to the file.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#gen_file-1",
"page": "Plugin Development",
"title": "gen_file",
"category": "section",
"text": "gen_file"
},
{
"location": "pages/plugin_development/#PkgTemplates.substitute",
"page": "Plugin Development",
"title": "PkgTemplates.substitute",
"category": "function",
"text": "substitute(template::AbstractString, view::Dict{String, Any}) -> String\nsubstitute(\n template::AbstractString,\n pkg_template::Template;\n view::Dict{String, Any}=Dict{String, Any}(),\n) -> String\n\nReplace placeholders in template with values in view via Mustache. template is not modified. If pkg_template is supplied, some default replacements are also performed.\n\nFor information on how to structure template, see \"Defining Template Files\" section in Custom Plugins.\n\nNote: Conditionals in template without a corresponding key in view won\'t error, but will simply be evaluated as false.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#substitute-1",
"page": "Plugin Development",
"title": "substitute",
"category": "section",
"text": "substitute"
},
{
"location": "pages/plugin_development/#PkgTemplates.Badge",
"page": "Plugin Development",
"title": "PkgTemplates.Badge",
"category": "type",
"text": "Badge(hover::AbstractString, image::AbstractString, link::AbstractString) -> Badge\n\nA Badge contains the data necessary to generate a Markdown badge.\n\nArguments\n\nhover::AbstractString: Text to appear when the mouse is hovered over the badge.\nimage::AbstractString: URL to the image to display.\nlink::AbstractString: URL to go to upon clicking the badge.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#Badge-1",
"page": "Plugin Development",
"title": "Badge",
"category": "section",
"text": "Badge"
},
{
"location": "pages/plugin_development/#PkgTemplates.format",
"page": "Plugin Development",
"title": "PkgTemplates.format",
"category": "function",
"text": "format(b::Badge) -> String\n\nReturn badge\'s data formatted as a Markdown string.\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#format-1",
"page": "Plugin Development",
"title": "format",
"category": "section",
"text": "format"
},
{
"location": "pages/plugin_development/#PkgTemplates.version_floor",
"page": "Plugin Development",
"title": "PkgTemplates.version_floor",
"category": "function",
"text": "version_floor(v::VersionNumber=VERSION) -> String\n\nFormat the given Julia version.\n\nKeyword arguments\n\nv::VersionNumber=VERSION: Version to floor.\n\nReturns \"major.minor\" for the most recent release version relative to v. For prereleases with v.minor == v.patch == 0, returns \"major.minor-\".\n\n\n\n\n\n"
},
{
"location": "pages/plugin_development/#version_floor-1",
"page": "Plugin Development",
"title": "version_floor",
"category": "section",
"text": "version_floor"
},
{
"location": "pages/licenses/#",
"page": "Licenses",
"title": "Licenses",
"category": "page",
"text": "CurrentModule = PkgTemplates"
},
{
"location": "pages/licenses/#PkgTemplates.available_licenses",
"page": "Licenses",
"title": "PkgTemplates.available_licenses",
"category": "function",
"text": "available_licenses([io::IO]) -> Nothing\n\nPrint the names of all available licenses.\n\n\n\n\n\n"
},
{
"location": "pages/licenses/#PkgTemplates.show_license",
"page": "Licenses",
"title": "PkgTemplates.show_license",
"category": "function",
"text": "show_license([io::IO], license::AbstractString) -> Nothing\n\nPrint the text of license. Errors if the license is not found.\n\n\n\n\n\n"
},
{
"location": "pages/licenses/#Licenses-1",
"page": "Licenses",
"title": "Licenses",
"category": "section",
"text": "Many open-source licenses are available for use with PkgTemplates, but if you see that one is missing, don\'t hesitate to open an issue or PR.available_licenses\nshow_license"
},
{
"location": "pages/licenses/#PkgTemplates.read_license",
"page": "Licenses",
"title": "PkgTemplates.read_license",
"category": "function",
"text": "read_license(license::AbstractString) -> String\n\nReturns the contents of license. Errors if the license is not found. Use available_licenses to view available licenses.\n\n\n\n\n\n"
},
{
"location": "pages/licenses/#Helper-Functions-1",
"page": "Licenses",
"title": "Helper Functions",
"category": "section",
"text": "read_license"
},
{
"location": "pages/#",
"page": "Index",
"title": "Index",
"category": "page",
"text": ""
},
{
"location": "pages/#Index-1",
"page": "Index",
"title": "Index",
"category": "section",
"text": ""
},
]}

1
v0.4.1/siteinfo.js Normal file
View File

@ -0,0 +1 @@
var DOCUMENTER_CURRENT_VERSION = "v0.4.1";