java
/
jMonkeyEngine-wiki
mirrorاز https://github.com/jMonkeyEngine/wiki.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536
							<!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.4"><meta name="author" content="mitm"><title>Anatomy of a Wiki Header</title><link rel="stylesheet" href="./asciidoctor.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
<link rel="stylesheet" href="./coderay-asciidoctor.css"><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/2/docsearch.min.css"></head><body class="article toc2 toc-left"><div id="header"><div id="toolbar"><a href="https://github.com/jMonkeyEngine/wiki/edit/master/src/docs/asciidoc/wiki/wiki_header.adoc"><i class="fa fa-pencil-square" aria-hidden="true"></i></a><a href="https://github.com/jMonkeyEngine/wiki/new/master/src/docs/asciidoc/wiki/"><i class="fa fa-plus-square" aria-hidden="true"></i></a><input dir="auto" style="position: relative; vertical-align: top;" spellcheck="false" autocomplete="off" class="searchbox__input aa-input" id="doc-search" name="search" placeholder="Search in the doc" required="required" type="search"><i class="fa fa-sort-down" aria-hidden="true"></i></div><h1>Anatomy of a Wiki Header</h1><div class="details"><span class="author" id="author">mitm</span><br><span id="revnumber">version ,</span> <span id="revdate">2017-09-08T23:24:11.262Z</span></div><div id="toc" class="toc2"><div id="toctitle">Table of Contents</div></div></div><div id="content"><div class="paragraph"><p>All wiki documents use these header attributes. Optional attributes can be left blank following the <kbd>:</kbd> colon symbol.</p></div>
<div class="listingblock"><div class="content"><pre class="CodeRay highlight"><code>= Enter Document Title Here
:author:
:revnumber:
:revdate:
:relfileprefix: ../../
:imagesdir: ../..
:experimental:
ifdef::env-github,env-browser[:outfilesuffix: .adoc]</code></pre></div></div>
<div class="paragraph"><p><strong>=</strong> Mandatory. Title of your document.</p></div>
<div class="paragraph"><p><strong>:author:</strong> Optional. Document author.</p></div>
<div class="paragraph"><p><strong>:revnumber:</strong> Optional. Revision number.</p></div>
<div class="paragraph"><p><strong>:revdate:</strong> Optional. Revision Date</p></div>
<div class="paragraph"><p><strong>:relfileprefix:</strong> Mandatory. Enter a path to the &#8220;asciidoc&#8221; folder.</p></div>
<div class="admonitionblock tip"><table><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">Use <code>Tree View</code> (<kbd>ctrl</kbd>+<kbd>\</kbd> or <code><span class="menuseq"><span class="menu">View</span>&#160;&#9656; <span class="menuitem">Toggle Tree View</span></span></code>) to locate the &#8220;asciidoc&#8221; folder if using the <a href="https://atom.io/">Atom editor</a>.</td></tr></table></div>
<div class="paragraph"><p>In the example below, &#8220;asciidoc&#8221; is two folders above the folder this file is located in.</p></div>
<div class="paragraph"><p><code>:relfileprefix: ../../</code></p></div>
<div class="paragraph"><p><strong>:imagesdir:</strong> Mandatory. Enter a path to the "images" folder.</p></div>
<div class="admonitionblock tip"><table><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">Use <code>Tree View</code> (<kbd>ctrl</kbd>+<kbd>\</kbd> or <code><span class="menuseq"><span class="menu">View</span>&#160;&#9656; <span class="menuitem">Toggle Tree View</span></span></code>) to locate the &#8220;images&#8221; folder if using the <a href="https://atom.io/">Atom editor</a>.</td></tr></table></div>
<div class="paragraph"><p>In the example below, &#8220;images&#8221; is two folders above the folder this file is located in. Note the missing <kbd>/</kbd> forward slash.</p></div>
<div class="paragraph"><p><code>:imagesdir: ../..</code></p></div>
<div class="admonitionblock tip"><table><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content"><div class="paragraph"><p>A simple way to determine the location of the "asciidoc" and "images" folder in the Atom editor is first save the file to its new location, then in <code>Tree View</code> (<kbd>ctrl</kbd>+<kbd>\</kbd> or <code><span class="menuseq"><span class="menu">View</span>&#160;&#9656; <span class="menuitem">Toggle Tree View</span></span></code>), <b class="button">RMB</b> select the saved file and select <b class="button">Copy Project Path</b>.</p></div>
<div class="paragraph"><p>Temporarily paste this into your document to see where the &#8220;asciidoc&#8221; folder is located.</p></div>
<div class="paragraph"><p>For example: <code>src\docs\asciidoc\jme3\advanced\3d_models.adoc</code></p></div>
<div class="paragraph"><p>In this example, "asciidoc" is located two folders above the "advanced" folder <code>3d_models.adoc</code> resides in.</p></div>
<div class="paragraph"><p>You can find this same folder information using <a href="https://github.com/jMonkeyEngine/wiki/blob/master/src/docs/asciidoc/jme3/advanced/3d_models.adoc">GitHub</a>.</p></div></td></tr></table></div>
<div class="paragraph"><p>The &#8220;images&#8221; folder resides in the same folder as the &#8220;asciidoc&#8221; folder so it has the same setting minus the <kbd>/</kbd> forward slash.</p></div>
<div class="paragraph"><p><strong>:experimental:</strong> Leave this blank. This is the experimental attribute that allows the use of <a href="http://asciidoctor.org/docs/user-manual/#user-interface-macros">User Interface Macros</a>. You use these macros for creating keyboard shortcuts, displaying menu selections and UI buttons.</p></div>
<div class="paragraph"><p><strong>ifdef::env-github,env-browser[:outfilesuffix: .adoc]</strong> See <a href="http://asciidoctor.org/docs/user-manual/#navigating-between-source-files">Navigating Between Source Files</a> in the AsciiDoctor user manual. Leave this as written.</p></div></div><div id="footer"><div id="footer-text">Version <br>Last updated 2017-10-25 21:59:24 +00:00</div></div><script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/2/docsearch.min.js"></script><script>docsearch({
  apiKey: 'a736b6d93de805e26ec2f49b55013fbd',
  indexName: 'jmonkeyengine',
  inputSelector: '#doc-search',
  debug: false // Set debug to true if you want to inspect the dropdown
});</script></body></html>