gddo icon indicating copy to clipboard operation
gddo copied to clipboard

question: can we use custom templates to serve the docs?

Open neumachen opened this issue 9 years ago • 6 comments
trafficstars

Can we use custom templates to serve the docs? If so, how is that achieved?

neumachen avatar Apr 18 '16 16:04 neumachen

I'm not quite sure what you mean by custom templates, can you give an example of what it'd be like? I'm guessing the answer is there is no such thing on godoc.org.

Are you already familiar with all the features that Go allows you to use in formatting the docs? https://godoc.org/github.com/natefinch/godocgo is a good explanation and demonstration of most features.

dmitshur avatar Apr 18 '16 19:04 dmitshur

I mean can we add styling to the html pages that get generated? Something like this I guess, http://dhconnelly.github.io/docgo/docgo.html.

neumachen avatar Apr 20 '16 03:04 neumachen

docgo looks really cool.

I mean can we add styling to the html pages that get generated?

As far as I know, and assuming I understand correctly, I don't think that the list of features that godoc.org supports includes that (unless you modify its source, of course).

dmitshur avatar Apr 20 '16 03:04 dmitshur

@shurcooL yeah I know right? I thought this was possible in the earlier versions of gddo with a -template flag. Bit I could be wrong. I mean I love godocs and all but I want to add a bit of custom design to it while still be up to date with this repo's master.

neumachen avatar Apr 20 '16 13:04 neumachen

Any finding on that?

ivansantosz avatar Apr 27 '19 18:04 ivansantosz

Looks like you can pass a custom path to the assets folder using -assets path.

jackwilsdon avatar Apr 27 '19 19:04 jackwilsdon