Page 2 of 29 FirstFirst 123412 ... LastLast
Results 11 to 20 of 288

Thread: JSDuck - the tool for documenting your Ext JS apps

  1. #11
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
      0  

    Default

    Thanks for the response. I'll try {@img} in the guide.

    I figured out the multiple --image tag shortly after posting my question. The reason I set it to c:\jsduck\content is because that's the root folder, so I would specify images\image.png and guides\guide\image.png, etc., for the images. I suppose I can specify two --image options, one for c:\jsduck\images and one for c:\jsduck\guides, as long as I don't place image files directly in the guides folder, as this could potentially run the risk of two images with the same name getting copied to the same place, right?

    Whenever I try to specify the --img tag, I get an error saying '< was unexpected at this time'. I've tried every permutation of specifying quotes that I could think of, even tried it without the quotes, and had no success. I want to add the title attribute to the image tag. I get the same error when I copy and paste the example you provided.
    Code:
    jsduck --img '<p><img src="%u" alt="%a"></p>'
    One unrelated question:
    For the meta-tags option, not knowing Ruby or its naming conventions, do I have to name a Ruby class file to be the same as its class name? I played briefly with a simple example and it seemed to be ignoring it, so I didn't pursue it any further.

    Thanks for all your great work on this!

  2. #12
    Sencha User renku's Avatar
    Join Date
    Feb 2009
    Location
    Estonia
    Posts
    437
    Vote Rating
    17
      0  

    Default

    as long as I don't place image files directly in the guides folder, as this could potentially run the risk of two images with the same name getting copied to the same place, right?
    Right. That's again one of the things to improve.

    As for the --img option, I guess Windows doesn't support single quotes, have you tried reversing the single and double quotes? You might also attempt to use the windows escape character ^, but I guess you would end up escaping way too many things.

    Ruby doesn't care how your files are named, but the convention is to place SomeCoolClass into either some_cool_class.rb or somecoolclass.rb - I find the first one more readable.

  3. #13
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
      0  

    Default

    Just tried the {@img} tag in a guide, and here is the problem I face.

    I now specify --images=c:\jsduck\content\images --images=c:\jsduck\content\guides, but if I do this to pick up an image from the images folder:
    Code:
    {@img image.png}
    It creates a URL relative to where the markdown file for the guide is, so I get a broken image. Therefore, I have to specify --images=c:\jsduck\content as the root, so I can reference {@img images/image.png} in the guide. But then that doesn't work, either, because {@img} is creating a URL that is relative to where the markdown file lives (though it is odd that if I specify {@img guides/guide/image.png} it works).

    I am completely unable to get an image to appear from the c:\jsduck\content\images folder from within a guide using the {@img} syntax in a guide, but it works from doc-comments. I guess that is OK if the convention is to keep all images relevant to a guide in with the guide folder, but it does make it tricky to pull up a common image.

    As for the markdown syntax, I have to specify ![Alt text](images/image.png), which seems inconsistent with {@img image.png} to retrieve the same image. I get confused as to why I have to specify images/images/image.png if I simply name c:\jsduck\content\images as the root, but I don't have to specify images/guides/guide/image.png. There seems to be some logic in there somewhere muddying the water, or some concept I'm missing.

  4. #14
    Sencha User renku's Avatar
    Join Date
    Feb 2009
    Location
    Estonia
    Posts
    437
    Vote Rating
    17
      0  

    Default

    As I told earlier, the sharing of images between doc-comments and guides doesn't work.

    The Markdown syntax is a hack to overcome this limitation - you are simply referencing some image relative to the main directory of JSDuck output folder.

    It's crappy, I agree.

  5. #15
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
      0  

    Default

    Turns out the problem was with the % character. I got this to work in Windows:
    --img="<p><img src='%%u' alt='%%a' title='%%a'></p>"
    Windows. >sigh<

    And I now understand what you mean by "the sharing of images between doc-comments and guides doesn't work". I didn't fully comprehend what that meant earlier, but now I get what you're saying.

  6. #16
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
      0  

    Default

    Is there a way to display the text "{@img sample.png}" in a guide without it interpreting the tag?

  7. #17
    Sencha User renku's Avatar
    Join Date
    Feb 2009
    Location
    Estonia
    Posts
    437
    Vote Rating
    17
      0  

    Default

    Unfortunately I haven't implemented any escaping. You might try something like:

    <span>{</span>@img sample.png}

  8. #18
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
      0  

    Default Error during doc build

    Any idea what would cause this?

    Code:
    C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1304:in `unlink': Permission denied - d:/build/jsdoc/extjs/ext-all.js (Errno::EACCES)
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1304:in `remove_file'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1312:in `platform_support'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1303:in `remove_file'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1292:in `remove'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:762:in `remove_entry'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1342:in `postorder_traverse'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1342:in `postorder_traverse'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1346:in `postorder_traverse'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1341:in `postorder_traverse'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1340:in `each'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1340:in `postorder_traverse'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1341:in `postorder_traverse'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1340:in `each'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:1340:in `postorder_traverse'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:760:in `remove_entry'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:613:in `rm_r'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:609:in `each'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/1.8/fileutils.rb:609:in `rm_r'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/gems/1.8/gems/jsduck-3.0.1/lib/jsduck/app.rb:248:in `clear_output_dir'
        from C:/DOCUME~1/WHUBBA~2.SAB/LOCALS~1/Temp/ocr496.tmp/lib/ruby/gems/1.8/gems/jsduck-3.0.1/lib/jsduck/app.rb:80:in `run'

  9. #19
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
      0  

    Default

    I found the cause of the problem. The first line in the file that makes this crash had this line of code in it:
    Code:
    $log.level = $log.DEBUG;  //[*] DO NOT CHECK THIS IN
    Not sure why that would make it die, but removing this (merely // commenting it out) allowed the doc build to succeed.

  10. #20
    Sencha - Community Support Team SamuraiJack1's Avatar
    Join Date
    May 2008
    Posts
    567
    Vote Rating
    5
      0  

    Default

    Quote Originally Posted by renku View Post
    Strange that nobody has asked for this before. I downgraded the required RubyGems to 1.3.5 and released JSDuck 3.0.1.

    The only reason I required 1.3.7 was me having this version when I released JSDuck 0.1.
    Works now, thanks a lot!

Page 2 of 29 FirstFirst 123412 ... LastLast

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •