wenchun / jsdoc-toolkit

Automatically exported from code.google.com/p/jsdoc-toolkit
0 stars 0 forks source link

Templating problems #165

Closed GoogleCodeExporter closed 8 years ago

GoogleCodeExporter commented 8 years ago
Hello,

For the company I work for, I'm creating a custom template for JsDoc with
the colors and look and feel of the rest of the brand. I, however,
experience some weird problems.

- To start with an easy one: why can I style all pages except the ones in
output/symbols/src/? I'd like to make a template with links to the Class
Index and a list of all files.

- If I have something like this:

var namespace = {
 /** @constructor */
 init: function() {
  // do init stuff
  namespace.class1.init();
  namespace.class2.init();
 },

 class1: {
  /** @constructor */
  init: function() {},
  otherFunction1: function() {}
 },

 class2: {
  /** @constructor */
  init: function() {},
  otherFunction1: function() {},
  otherFunction2: function() {}
 }
}

I get way too much files if I do this. There are separate files for both
the namespace.classname.init() functions, and the files for
namespace.classname do not contain the init() functions at all. I want the
sepearte files for the init functions to be removed.

Also, I want to be able to do something like this in my templates: {! if
(member.isConstructor) output += "CONSTRUCTOR"; !}

- Is it possible to *copy* all files from /jsdoc/template/tpl_name/static/
to /output/static/? I'd like to place images, CSS and JavaScript files in
that directory, so I can call them from my output HTML files. I see that
the default template uses an include, which is quite stupid. (And now I
mention the includes, why can't I use template tags in those files? I tried
to make a footer.html that uses a simple {+new Date()+} but that was not
parsed.)

- I cannot output some information like the type or description for
properties/fields/config's, or the author of a file. I've tried multiple
methods to display it, but none worked. This {+member.name+} displays the
name, but {+member.type+} doesn't display the type.

Thanks in advance for every reply to this message!

-Arjan

Original issue reported on code.google.com by ar...@info.nl on 8 Jul 2008 at 2:04

GoogleCodeExporter commented 8 years ago
A colleague of mine found a way to copy the images, CSS and JS files by 
configuring
publish.js. I didn't find anything about publish.js in the JsDoc documentation, 
but
my colleague found it in a template made by someone else.

But the other three issues remain...

Original comment by ar...@info.nl on 10 Jul 2008 at 2:41

GoogleCodeExporter commented 8 years ago
I would suggest you not call my work "quite stupid" if you seriously expect my 
help in future. Good luck with 
your template.

Original comment by micmath on 11 Jul 2008 at 11:35

GoogleCodeExporter commented 8 years ago
I'm sorry for offending you, that was absolutely not my intention.

Original comment by ar...@info.nl on 14 Jul 2008 at 12:29