dontangg / nocco Goto Github PK

I'm on a Mac and don't have access to VisualStudio, but I'd like to give nocco a go. Could someone please add a tarball or similar of the executable to the repo? I'd much appreciative; Thank you in advance.

Sorry if I'm being stupid but how do you install it?

It took me a little longer than expected to get the project to compile in the first instance as I had to hunt for a couple of the dependencies. It might be worth calling these out explicitly in the Readme file and/or the Nocco.cs header comments:

• MarkdownSharp - I know this is mentioned in the code comments themselves, but might be worth including in the header when first talking about Markdown.
• System.Web.Razor - I'm running Visual Studio 2010 Ultimate w/ SP1 and I still had to download the MVC3 update to get this assembly installed.

In some of my comments are German umlauts:

ä, ö, ü

All of them translate in the HTML to:

�

Hi, I'm trying to modify the source to filter out inline comments (unfortunately some of our old code has these). Without filtering, I find that the rest of my code turns green :)

I tried:

public Regex CommentMatcher { get { return new Regex(@"^\s_\w._" + Symbol + @"\s?"); } }

which works for:

if (blah) { ' blah is nice

but also picks out:

"this is a blah '{0}' la la la"

from a string.format, for example.

Do you have any pointers that could help me in the right direction?

Regards

Ash

Since this is a documentation tool for .NET, I think it would be neat if Nocco could parse and output the /// XML comments that Visual Studio supports. True, not all .NET development is done in VS, but I think this would be a nice feature. Does this break the "quick and dirty" principle, though?

It would be nice to know what the license for this software is. I suggest MIT.

Is this repository actively maintained?
There are some PRs that haven't received love.
If not, maybe archive it.

Hi!

Is it possible to customize the --outdir like with docco? At the moment nocco seems not to recognize any parameter at all. Is that right?

Best,
Jochen