Thanks Justin I will give it a try. (It certainly would be nice if "*godoc -html"* could be useful without having to modify the html.)
On Saturday, December 16, 2017 at 6:41:07 PM UTC-5, Justin Israel wrote: > > > > On Sun, Dec 17, 2017 at 5:47 AM <jake...@gmail.com <javascript:>> wrote: > >> I suspected it was something like that. I can muddle through, but HTML, >> and all that is not really my wheelhouse. Can you give me any more details? >> >> >> - Where can I find the correct "bundled css/js" files? >> >> https://godoc.org/-/bootstrap.min.css > https://godoc.org/-/site.css > > >> >> - Where do I put them relative to the HTML file? >> >> That will be up to you, since you will need to actually format a > full-formed html file > >> >> - Do I need to modify the HTML file to use them? >> >> Yea. The output from godoc -html is only a snippet. You would need to > inspect the source of godoc.org to see an example of what you would need > to do: > view-source:https://godoc.org/os > > The css files are responsible for formatting the look of the page. > > >> Thanks >> >> - Jake >> >> On Friday, December 15, 2017 at 5:23:59 PM UTC-5, Justin Israel wrote: >>> >>> >>> >>> On Fri, Dec 15, 2017, 7:35 AM <jake...@gmail.com> wrote: >>> >>>> I run godoc like this: >>>> >>>> *godoc -html jake\tmp > doc.html* >>>> >>>> When I open the resulting file (in Chrome or Firefox) the result look >>>> terrible. The resulting file is attached. The collapsible sections display >>>> as two separate items, are not collapsible, and in Firefox there are >>>> strange characters instead of arrows. The preformed text blocks are hard >>>> to >>>> see, since they contain no special boarder or background and are not >>>> indented. The links display all the time as "ΒΆ". Etc, etc. >>>> >>>> So, how can I easily create and view documentation for my library that >>>> looks more like the documentation at https://golang.org/pkg/ ? >>>> >>>> Thanks. >>>> >>> >>> It's because you are missing the css/js files that godoc pages use. In >>> my studio build system, for the godoc support in our Go plugin, I have it >>> deploying docs with the bundled css/js >>> >> -- >>>> You received this message because you are subscribed to the Google >>>> Groups "golang-nuts" group. >>>> >>> To unsubscribe from this group and stop receiving emails from it, send >>>> an email to golang-nuts...@googlegroups.com. >>> >>> >>>> For more options, visit https://groups.google.com/d/optout. >>>> >>> -- >> You received this message because you are subscribed to the Google Groups >> "golang-nuts" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to golang-nuts...@googlegroups.com <javascript:>. >> For more options, visit https://groups.google.com/d/optout. >> > -- You received this message because you are subscribed to the Google Groups "golang-nuts" group. To unsubscribe from this group and stop receiving emails from it, send an email to golang-nuts+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
