I've had some time to polish this project somewhat. It should be fairly usable.
I've added ZIP archive generation to allow browsing offline without godoc. Any additional feedback is welcome. On Monday, February 10, 2020 at 8:22:51 AM UTC-8, Trevor Slocum wrote: > > Hey Nick, I did consider that and hope to still visit it. I chose to > scrape instead because the output requires only minimal alteration to > achieve the desired result. Example code expansion is rewritten to not > require JavaScript by using <details> and <summary> and not much more. > Large changes to output from the godoc tool can certainly break > godoc-static in its current state. Assistance with exploring generating > similar output without using godoc would be appreciated. > > > On Monday, February 10, 2020 at 7:14:51 AM UTC-8, Nick wrote: >> >> Quoth tsl...@gmail.com: >> > Inspired by the recent news of godoc.org shutting down I have created >> > godoc-static. While we could all migrate to pkg.go.dev >> <http://www.google.com/url?q=http%3A%2F%2Fpkg.go.dev&sa=D&sntz=1&usg=AFQjCNFD8_H2Rd0Wkru18VMbgo-izMbd9Q>, >> >> we could also host and >> > update our documentation ourselves. >> >> Cool, sounds interesting, I like the idea of more tools to make more >> distributed hosting of go stuff easier! >> >> > When invoked, "godoc -http=localhost:####" is started, relevant package >> > documentation pages and source code is scraped and rewritten to fix >> styling, >> > expanding content, etc., then godoc is terminated. >> >> Interesting approach. Did you consider taking the code that godoc >> uses (either direct copying or including it somehow) and generating >> the HTML directly? I can imagine that might not be straightforward, >> but I'm interested to hear why you chose this approach instead. >> Without having looked at the code, I would imagine it would be more >> liable to break with future versions of godoc which change the >> output. >> >> Anyway, good job, I may use it myself soon, and will let you know >> how I get on. >> >> Nick >> > -- 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. To view this discussion on the web visit https://groups.google.com/d/msgid/golang-nuts/68e59b93-511d-466b-ab7b-4038d3d85df0%40googlegroups.com.
