Documentation Plugin



  • Hi everyone,

    I have released a plugin I use to create documentation for my plugins.

    The plugin is free. Currently available for R20 for Windows. I will add an OSX version if people ask for it.

    https://www.plugins4d.com/docs

    If you use it for anything let me know. Also if you have any features requests then send them my way.

    Cheers,
    Kent



  • Hi Kent
    Interesting. I'd like to test it, but I'm on Mac ;)
    Is it compatible with versions prior to R20?



  • Really cool Kent! Thank you for sharing.

    Questions:

    • Does your plugin provide any sort of automation for adding "Show Help" links in C4D to specific parameters?

    Feature requests:

    • Automatically fill in the image Alt-Text for the linked command icons with the name of the command/parameter.
    • Auto List Parameters: Add a list of every parameter in a plugin's dialog/description so that we can easily document elements and see what isn't yet documented.


  • For Show Help, I could include a separate library to pop up a help dialog with the correct page, I already have it implemented in my other plugins. But if you wish to pop up your own dialog, or just launch a browser with the link, you can add the ID of the page to the end of the index.html?id=SECTIONID

    So something like this: https://help.plugins4d.com/?id=1026

    You can get the id for a page by right clicking on the section and choosing "Copy ID To Clipboard".

    I will add in your feature requests to my list.

    OSX will be coming later on. At the moment I am only support R20 since its a free plugin, so don't have the time/resources to put into it.



  • I just updated the plugin to include the Alt-Text for command icons.

    When you drag and drop a command into the DropZone and then paste your text into the section you will get something like this...

    ![Add Doodle Frame][COMMAND_1022215]

    It will look like this in the HTML code when published...

    <p><img src="images/COMMAND_1022215.png" alt="Add Doodle Frame"/></p>



  • Very usefull plugin! 😎 ✌ Thanks!



  • Hi Kent,

    thanks for sharing this!

    Cheers,
    Andreas



  • I'm trying to use this super handy plug-in to build help system for my plug-ins.
    Thanks for sharing this!
    After some days of working i have a some suggestions and bug reports.

    1. After each publishing, resulting index.html have a title tag "Plugins 4D Documentation".
    2. Is it possible to add ability inserting images with other formats like gif, jpg? Now i have to copy my images to images folder and type using markdown code like this (not showing in Preview window):
    ![Target 4D Move tool](images/mikeudin-target4d-feutures_5.gif "Target 4D Move tool")
    
    1. Preview window stops showing any text content if it contains symbol '–'. But after publishing results, final HTML is ok.
    2. Would be great to add ability to add favicon image.

Log in to reply