forked from MoonsideGames/FAudioGMS-Docs
243 lines
8.8 KiB
HTML
243 lines
8.8 KiB
HTML
<!-- HOW TO & TIPS -->
|
|
<!--
|
|
UPDATING MINOR VERSIONS:
|
|
1. Just change the `latestVersion` variable to the new version.
|
|
|
|
UPDATING MAJOR VERSIONS: (for example, let's say we are upgrading from v2.4.5 -> v3.0.0)
|
|
1. Add '2.4.5' to the `otherVersions` array.
|
|
2. Update the `latestVersion` variable to '3.0.0'.
|
|
3. Rename the `latest` docs folder to '2.4.5'.
|
|
4. Create a new docs folder named 'latest' and store your v3.0.0 docs inside there.
|
|
|
|
PREVIEWING CHANGES:
|
|
- If you'd like to make future modifications to markdown files and preview them before pushing your changes,
|
|
you can do so with either Python or Node. If you have Node installed you can install Docsify with
|
|
'npm i docsify-cli -g' and then navigate to the docs folder and run 'docsify serve'. With Python you
|
|
can manually serve your docs with 'cd docs && python -m http.server 3000'.
|
|
More info: https://docsify.js.org/#/quickstart
|
|
|
|
OTHER TIPS:
|
|
- If you want a different sidebar or navbar for different versions,
|
|
you can just copy and paste the _sidebar.md or _navbar.md from the
|
|
main /docs/ folder into the version folder you'd like and modify it there.
|
|
-->
|
|
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<title>FAudioGMS Documentation</title>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
|
|
<meta
|
|
name="description"
|
|
content="An extension for Game Maker Studio 2 that allows Game Maker applications to utilize FAudio"
|
|
/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0" />
|
|
<!-- Theme: Simple Dark -->
|
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple-dark.css" />
|
|
<link rel="stylesheet" href="https://unpkg.com/dracula-prism/dist/css/dracula-prism.min.css" />
|
|
</head>
|
|
<body>
|
|
<div id="app"></div>
|
|
<script>
|
|
/* APP INFO */
|
|
const appName = 'FAudioGMS';
|
|
const latestVersion = '0.2.0';
|
|
const otherVersions = [];
|
|
|
|
/* DOCSIFY CONFIG */
|
|
window.$docsify = {
|
|
name:
|
|
'<a id="home-link" class="app-name-link" data-nosearch href="/"><span id="home-text">' +
|
|
appName +
|
|
' Docs</span><br></a>' +
|
|
'<select id="version-selector" name="version">' +
|
|
'</select>',
|
|
nameLink: false,
|
|
loadSidebar: true,
|
|
loadNavbar: true,
|
|
subMaxLevel: 3,
|
|
relativePath: true,
|
|
auto2top: true,
|
|
footer: {
|
|
pre: '<br><hr>',
|
|
copy: '<span>' + appName + ' © ' + new Date().getFullYear() + '</span>',
|
|
auth:
|
|
'by <a href="https://twitter.com/thatcosmonaut/" target="_blank">Evan Hemsley</a>' +
|
|
'<br>Docs created by <a href="https://twitter.com/faultyfunctions/" target="_blank">Faulty</a> ' +
|
|
'with <a href="https://github.com/docsifyjs/docsify/" target="_blank">Docsify</a>',
|
|
style: 'text-align: right;',
|
|
},
|
|
tabs: {
|
|
persist: false,
|
|
sync: false,
|
|
theme: 'classic',
|
|
tabComments: false,
|
|
tabHeadings: true,
|
|
},
|
|
copyCode: {
|
|
buttonText: '📋',
|
|
},
|
|
search: {
|
|
paths: 'auto',
|
|
namespace: 'chatterbox',
|
|
hideOtherSidebarContent: true,
|
|
depth: 3,
|
|
pathNamespaces: (() => {
|
|
let pathNamespacesArray = ['/latest'];
|
|
for (const version of otherVersions) {
|
|
pathNamespacesArray.push('/' + version);
|
|
}
|
|
return pathNamespacesArray;
|
|
})(), // Run a self executed function to construct our pathNamespaces
|
|
},
|
|
namespaces: [
|
|
{
|
|
id: 'version',
|
|
values: ['latest', ...otherVersions],
|
|
optional: true,
|
|
default: 'latest',
|
|
selector: '#version-selector',
|
|
},
|
|
],
|
|
plugins: [
|
|
function (hook, vm) {
|
|
// ENSURE CLICKING THE LOGO TAKES US TO THE CORRECT VERSION DOCS
|
|
hook.doneEach(() => {
|
|
var appNameLink = Docsify.dom.find('#home-link');
|
|
|
|
if (appNameLink) {
|
|
appNameLink.href = vm.config.currentNamespace;
|
|
}
|
|
|
|
// ENSURE ANCHOR LINKS WILL STILL SCROLL INTO VIEW AS MANY TIMES AS NEEDED
|
|
var sidebarLinks = document.getElementsByTagName('a');
|
|
for (let link of sidebarLinks) {
|
|
if (Docsify.util.isExternal(link.href) === false) {
|
|
link.addEventListener('click', e => {
|
|
// Only trigger hash changes on parent "A" link elements
|
|
if (e.target.tagName == 'A') {
|
|
location.hash = '#dummy-hash'; // Dummy hash to change URL
|
|
history.replaceState(null, null, e.currentTarget.href); // Replace dummy hash so the browser can jump to actual target
|
|
} else {
|
|
e.preventDefault();
|
|
e.stopPropagation();
|
|
e.currentTarget.click(); // Manually trigger a click event for the current target.
|
|
}
|
|
});
|
|
}
|
|
}
|
|
});
|
|
|
|
hook.mounted(() => {
|
|
const versionSelector = Docsify.dom.find('#version-selector');
|
|
|
|
// CONSTRUCT DATA FOR OUR VERSION SELECTOR
|
|
const versionSelections = [];
|
|
versionSelections.push({ text: 'v' + latestVersion, value: 'latest', isDefault: true });
|
|
for (const version of otherVersions) {
|
|
versionSelections.push({
|
|
text: 'v' + version,
|
|
value: version,
|
|
isDefault: false,
|
|
});
|
|
}
|
|
|
|
// POPULATE VERSION SELECTOR DROP DOWN
|
|
versionSelections.map((version, index) => {
|
|
versionSelector.options[index] = new Option(
|
|
version.text,
|
|
version.value,
|
|
version.isDefault
|
|
);
|
|
});
|
|
|
|
// COLOR THE SIDEBAR ARROWS
|
|
const themeColor = window
|
|
.getComputedStyle(document.documentElement)
|
|
.getPropertyValue('--theme-color');
|
|
|
|
document.documentElement.style.setProperty(
|
|
'--sidebar-nav-pagelink-background-image--collapse',
|
|
"url(\"data:image/svg+xml,%0A%3Csvg xmlns='http://www.w3.org/2000/svg' width='7' height='11.2' viewBox='0 0 7 11.2'%3E%3Cpath d='M1.5 1.5l4 4.1 -4 4.1' stroke-width='1.5' stroke='" +
|
|
themeColor +
|
|
"' fill='none' stroke-linecap='square' stroke-linejoin='miter' vector-effect='non-scaling-stroke'/%3E%3C/svg%3E\")"
|
|
);
|
|
|
|
document.documentElement.style.setProperty(
|
|
'--sidebar-nav-pagelink-background-image--active',
|
|
"url(\"data:image/svg+xml,%0A%3Csvg xmlns='http://www.w3.org/2000/svg' width='11.2' height='7' viewBox='0 0 11.2 7'%3E%3Cpath d='M1.5 1.5l4.1 4 4.1-4' stroke-width='1.5' stroke='" +
|
|
themeColor +
|
|
"' fill='none' stroke-linecap='square' stroke-linejoin='miter' vector-effect='non-scaling-stroke'/%3E%3C/svg%3E\")"
|
|
);
|
|
|
|
document.documentElement.style.setProperty(
|
|
'--sidebar-nav-pagelink-background-image--loaded',
|
|
"url(\"data:image/svg+xml,%0A%3Csvg xmlns='http://www.w3.org/2000/svg' width='11.2' height='7' viewBox='0 0 11.2 7'%3E%3Cpath d='M1.5 1.5l4.1 4 4.1-4' stroke-width='1.5' stroke='" +
|
|
themeColor +
|
|
"' fill='none' stroke-linecap='square' stroke-linejoin='miter' vector-effect='non-scaling-stroke'/%3E%3C/svg%3E\")"
|
|
);
|
|
});
|
|
},
|
|
],
|
|
};
|
|
</script>
|
|
<!-- Docsify v4 -->
|
|
<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
|
|
<script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
|
|
<script src="//unpkg.com/docsify-namespaced/dist/docsify-namespaced.min.js"></script>
|
|
<script src="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/js/docsify-themeable.min.js"></script>
|
|
<script src="//unpkg.com/docsify-footer-enh/dist/docsify-footer-enh.min.js"></script>
|
|
<script src="https://cdn.jsdelivr.net/npm/docsify-tabs@1"></script>
|
|
<script src="https://unpkg.com/prismjs@1.24.0/components/prism-gml.min.js"></script>
|
|
<script src="https://unpkg.com/docsify-copy-code@2"></script>
|
|
<style>
|
|
:root {
|
|
/* Theme */
|
|
--background: #242e33;
|
|
--theme-hue: 47;
|
|
--theme-saturation: 100%;
|
|
--theme-lightness: 47%;
|
|
|
|
/* Content */
|
|
--content-max-width: 62em;
|
|
--link-color--hover: var(--theme-color);
|
|
--heading-h1-color: var(--theme-color);
|
|
--heading-h2-color: var(--theme-color);
|
|
--heading-h2-border-color: var(--theme-color);
|
|
--table-head-border-width: 1px;
|
|
--table-cell-border-width: 1px;
|
|
|
|
/* Navbar */
|
|
--navbar-root-border-color: var(--theme-color);
|
|
--navbar-root-color: var(--theme-color);
|
|
--navbar-root-color--hover: var(--background);
|
|
--navbar-root-background--hover: var(--theme-color);
|
|
--navbar-root-border-width: 1px;
|
|
--navbar-root-border-radius: 5px;
|
|
--navbar-root-padding: 5px;
|
|
--navbar-root-margin: 0 0 0 1em;
|
|
}
|
|
#version-selector {
|
|
background: var(--base-background-color);
|
|
color: var(--theme-color);
|
|
border-color: var(--blockquote-border-color);
|
|
border-radius: 5px;
|
|
margin-top: 0.75em;
|
|
padding: 0 5px;
|
|
}
|
|
pre[class*='language-'] {
|
|
border: 1px solid #1f282d;
|
|
overflow: auto;
|
|
position: relative;
|
|
}
|
|
a code:hover {
|
|
color: var(--theme-color) !important;
|
|
}
|
|
footer a {
|
|
text-decoration: none !important;
|
|
font-weight: bold;
|
|
}
|
|
</style>
|
|
</body>
|
|
</html>
|