On Sunday, 19 October 2014 at 01:11:39 UTC, Jeremy DeHaan wrote:
Although perhaps unnecessary, I added DDoc documentation to my
module for a short description of the body. This showed up in
the place I wanted it to be in when I built the html
documentation, so I was pretty happy. (below the module name
and before any module members)
I then went to override the DDOC macro to set it up with the
correct formatting with the rest of the site I'll be putting
the documentation on. The single line documentation I had
written for the module apparently does not reside in BODY, and
with the new formatting, it just casts it to the bottom of the
page. It now resides below the footer.
Is there anything I can do to correct this? If not then I'll
just say "screw it" and not bother, but I thought it looked
pretty nice. Especially for modules that have more than one
class in them.
It's hard to tell what's gone wrong but i'm guessing something
has been missed in your macro. For reference this is my ddoc file
that i use for generating html and it works great:
DDOC = <!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="content-type" content="text/html;
charset=utf-8" />
<link type="text/css"
href="http://www.nomad.so/ddoc/css/theme.css"; rel="stylesheet"
media="all" />
<script type="text/javascript"
src="http://www.nomad.so/ddoc/javascript/jquery-2.0.3.min.js";></script>
<script type="text/javascript"
src="http://www.nomad.so/ddoc/javascript/jquery.scrollTo.min.js";></script>
<script type="text/javascript"
src="http://www.nomad.so/ddoc/javascript/index.js";></script>
<title>$(TITLE)</title>
</head>
<body>
<h1>$(TITLE)</h1>
$(BODY)
</body>
</html>
H2 = <h2>$0</h2>
H3 = <h3>$0</h3>
STRONG = <strong>$0</strong>
EM = <em>$0</em>
PRE = <pre>$0</pre>
PARAM_TABLE = <table class="parameter-list">$0</table>
PARAM_ROW = $(TR $(TD $1)$(TD $2))
DDOC_DECL = $(H2 $0)
DDOC_DECL_DD = <div class="declaration-description">$0</div>
DDOC_CLASS_MEMBERS = <div class="class-members">$0</div>
DDOC_SUMMARY = $(P $0)
DDOC_DESCRIPTION = $(P $0)
DDOC_MEMBERS = <div class="members">$0</div>
DDOC_ENUM_MEMBERS = <div class="enum-members">$0</div>
DDOC_MODULE_MEMBERS = <div class="module-members">$0</div>
DDOC_STRUCT_MEMBERS = <div class="struct-members">$0</div>
DDOC_TEMPLATE_MEMBERS = <div class="template-members">$0</div>
DDOC_SECTIONS = <div class="sections">$0</div>
DDOC_SECTION = $(P $0)
DDOC_SECTION_H = $(H3 $0)
DDOC_PARAMS = $(H3 Parameters)$(PARAM_TABLE $0)
DDOC_PARAM_ROW = $(TR $0)
DDOC_PARAM_ID = $(TD $0)
DDOC_PARAM_DESC = $(TD $0)
DDOC_AUTHORS = $(H3 Authors)$(P $0)
DDOC_BUGS = $(H3 Bugs)$(P $0)
DDOC_COPYRIGHT = $(H3 Copyright)$(P $0)
DDOC_DATE = $(H3 Date)$(P $0)
DDOC_DEPRECATED = $(H3 Deprecation Information)$(P $0)
DDOC_EXAMPLES = $(H3 Examples)$(P $0)
DDOC_HISTORY = $(H3 History)$(P $0)
DDOC_LICENSE = $(H3 License)$(P $0)
DDOC_RETURNS = $(H3 Return Value)$(P $0)
DDOC_SEE_ALSO = $(H3 See Also)$(P $0)
DDOC_STANDARDS = $(H3 Standards)$(P $0)
DDOC_THROWS = $(H3 Exceptions Thrown)$(P $0)
DDOC_VERSION = $(H3 Version Information)$(P $0)
DDOC_PSYMBOL = <span class="symbol">$0</span>
DDOC_PSUPER_SYMBOL = <span class="super-symbol">$0</span>
DDOC_KEYWORD = $(STRONG $0)
DDOC_PARAM = $0
D_CODE = $(PRE $0)
D_COMMENT = <span class="comment">$0</span>
D_STRING = <span class="string">$0</span>
D_KEYWORD = <span class="keyword">$0</span>
D_PSYMBOL = <span class="symbol">$0</span>
D_PARAM = <span class="parameter">$0</span>
