AutoHotkey Community

This is really awesome, thanks.

Thx.

I might change it so it does AHK syntax highlighting in the future.

_________________

i have not seen how it looks. But i trust you blindly and know it is a good work like allways.
One question. Is it somehow possible to integrate html code into documentation? Have never tried this. Custom html should be usable in doc for better organizing it.

Nope, as far as i know. However, project is open source and I guess it will be easy to fix Perl script to support something like that. For instance with (start html) (end html) similar to (start code) (end code).
Thinking about it, it can be done by an ahk script too, without changing the NDoc Perl code. This would mean that I don't have to fix each new version of NDoc. For instance, I could mark html code like this:



You can located then this <pre>(start html) section and fix it (decode html and replace pre section with it) to get HTML injection.

Sounds feasibile... I might just do it when I find time.

_________________

i was more thinking to integrate single tags in and between paragraphs without marking it as a code section. Otherwise it takes the simplecity away. Or your suggested way could be combined with custom tags like BBCode, translated automatically.

OK, I implemented script that transforms ndoc html file with



to html without code section and given html instead.
The idea is good, Ill extend NDoc to support other extensions working as a post build Natural Docs script. The (html) extension is to be used with longer html paragraphs containing stuff like tables etc..

I'll support some form of small markup extensions - is it going to be bbcode or something else like textille is yet to be determined.

For now, you can use this simple script to use (html) extension:

_________________

Just discovered this the other day and started to play with it. Works great but I'll have to change my documentation style a little bit to get it to work the best. Thanks for sharing.

After long time of no coding, I needed a docu generation tool. In the past, I worked with Natural Docs, and it was ok. But before installing it again, I tried the GenDocs, which comes with the SciTE4AutoHotkey. After having an issue with it (still not reported by me), I am back to Natural Docs. It is easier and more powerful. I like it still. Here is a simple "make.ahk" script I use to generate the docs with mkdoc s:

This file can be named to whatever you will. It works as if the command line was open for that current directory and calls mkdoc s. But what if the is in an other directory as the script.

Then the script can be named to something like this: "make_dir", where "dir" is a relative folder to A_ScriptDir. The script sets then the WorkingDir to "%A_ScriptDir%\%dir%". This can be in example ".." to go one up in directory structure. Then the script to document is searched in that folder.

Do you have some other more or less useful scripts to work with Natural Docs? Please share or share your idea.

_________________
{1:"ahkstdlib", 2:"my libs", 3:"my apps", 4:"my license"}
--> Don't feed the troll! <--

Hi,
this is really great Thx majkinetor

I'm having some questions on it:

• Can you tell me what NDoc version it uses?
  If not yet up to date, could you please update it to 1.51 (or tell me how to do so):?:
  Would be very nice.
  
• mkdocs is also very useful. Question: Would it be possible to merge different files (as the forms framework docs) into one single file?
  (without merging the source files of course)
  
• Related to this and to anyone out here who has some knowledge of HTML:
  I like the idea of modifying the documents with AHK, but unfortunately I don't know anything about html.
  How could I make (page: [title]) tags start a new page just like different files?

Regards
maul.esel

_________________
RECOMMENDED: AutoHotkey_L

github - ImportTypeLib
Win7 HP SP1 32bit | AHK_L U 32bit

NaturalDocs 1.52 is released! Please update!

_________________
RECOMMENDED: AutoHotkey_L

github - ImportTypeLib
Win7 HP SP1 32bit | AHK_L U 32bit