On Saturday, 14 February 2015 at 09:17:57 UTC, Andrei
Alexandrescu wrote:
Counting on your help!
Here are some things that would help:
1. Most urgently, update the .dt template to match the current
Dlang.org style.
2. Ideally, the .dt templates need to be removed, and DDox made
to use the existing DDoc templates. This is so future website
updates are immediately reflected in DDox, to avoid this
situation in the future.
3. Currently, DDox creates all .html files regardless if they've
actually changed or not, thus making each generated file always
have a new modification time. Because the website is uploaded via
rsync, this greatly increases upload time. This can be solved by
making DDox first create a Makefile include, or by simply making
it not overwrite files with identical content.
There is generally something very broken about the DDox
templates. I've attempted to fix the website by adding a copy of
the old style.css, and I've modified layout.dt like so:
diff --git a/dpl-docs/views/layout.dt b/dpl-docs/views/layout.dt
index c4ddcb0..2960625 100644
--- a/dpl-docs/views/layout.dt
+++ b/dpl-docs/views/layout.dt
@@ -19,7 +19,7 @@ html(lang='en-US')
script(src='#{root_dir}js/d.js')
script(src='#{root_dir}js/run.js', type='text/javascript')
link(rel='stylesheet', href='#{root_dir}css/codemirror.css')
- link(rel='stylesheet', type='text/css',
href='#{root_dir}css/style.css')
+ link(rel='stylesheet', type='text/css',
href='#{root_dir}css/style-2014.css')
script(src='#{root_dir}js/hyphenate-selectively.js',
type='text/javascript')
script(type="text/javascript",
src="#{root_dir}prettify/prettify.js")
Yet, no matter what I do, which files I delete or how I attempt
to rebuild, the generated .html files still reference "style.css"
and not "style-2014.css".
I'm also getting strange linker errors when attempting to rebuild
DDox:
http://dump.thecybershadow.net/e6c93daabcbe9b01be9414d8d63913d8/0000009F.txt
These only happen SOMETIMES. They don't happen on a clean build.
I haven't identified the pattern, but it seems to vary between
working and not working without me changing anything in the
environment.
