Date: Tue, 16 Feb 2021 17:20:36 +0100 From: Daniel Ebdrup Jensen <debdrup@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Re: Edited web page does not update Message-ID: <20210216162036.tv7fvcv4jjd4rv6q@nerd-thinkpad.local> In-Reply-To: <CAFwocyPLTB16_fFZ=RvoxPUDTL3=pv5Pg5L60Tx_REVgxRNbqA@mail.gmail.com> References: <CAPu-kW994VRv0fGYHeQ1MKmSGZN%2B_XDDHkLAaEiYtXJhRA%2BcFA@mail.gmail.com> <CAFwocyPLTB16_fFZ=RvoxPUDTL3=pv5Pg5L60Tx_REVgxRNbqA@mail.gmail.com>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Tue, Feb 16, 2021 at 05:00:40PM +0100, Sergio Carlavilla wrote: >On Tue, 16 Feb 2021 at 16:54, Rob Belics <rob@belics.com> wrote: > >> I tried to dabble with updating documentation--specifically the web >> site--using this link: https://docs.freebsd.org/en/books/fdp-primer/ I put >> everything together and get the site to come up locally using Hugo as >> outlined. However, I do not understand how to edit the web pages. First, I >> can't find the home page (index) at all. Second, I tried editing the About >> page doc/website/content/en/about.adoc, and rebuilt the whole thing, but >> nothing changed when I refreshed the page. >> _______________________________________________ >> freebsd-doc@freebsd.org mailing list >> https://lists.freebsd.org/mailman/listinfo/freebsd-doc >> To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" >> >Hi Rob, > >First, thanks for your interest in helping us :) > >Second, can you tell me the commands you’re using? > >If you execute “make run” this should update the changes automatically. > >Bye. >_______________________________________________ >freebsd-doc@freebsd.org mailing list >https://lists.freebsd.org/mailman/listinfo/freebsd-doc >To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" Hi folks, To add to this a bit, my workflow is as follows: Optional: ensure that the HOSTNAME variable is set, so that hugo listens on a host that isn't localhost, as I run it on a server that's a bit more powerful than my old laptop. git checkout -b <branchname> `make -C /usr/doc/website run` (Replace website with documentation if you want to monitor the documentation) Alter whatever it is I wanna change, and save the file. Hugo should rebuild the changed part (although this doesn't always work, possibly due to includes; I've yet to root-cause this) git add . && git diff -staged Then rinse and repeat for the editing and git add'ing, until satisfied. Finally, make -C /usr/doc/website build, to make sure nothing else broke during all the editing. ;) The asciidoctor binary can also be used to lint files. If you grab git arc by doing `make -C /usr/src/tools/tools/git-arc build` and throw the install target at it afterwards (you'll need to be in the tree for 14-CURRENT for this), you can use git arc (and it's manual page, adopted to mdoc(7) by yours truly) to upload directly to reviews.freebsd.org. I hope this helps, but please feel free to reach out (preferably on #bsddocs on IRC) if necessary. Also, yes, I do intend to add this to the FDP, but it could be added by someone else too. *hint hint, wink wink, nudge nudge* Yours, Daniel Ebdrup Jensen [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAr8NRfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87rnMwf/azssfREk91t76N0XXNPbMKaCb18cDXk7oAgo8DKNc8IGUDnXBy3xkZKD SQ6cVtumyhUtElrVlfIjTKMKKs6KzUywrDt38VpVyrYjgTrpjfgRO7MCCOwGjo0u vutVOhSIve+WR+Kk67ZRzbnNsuTQN7ZiEDhAkX/GcsqzwowI8otZMyIUS4rZ2WkA tRDuaYWwHcbTUe8dZWlEFB1CFrXlEDqDykH+dmwDqTgEkT4OYQnni1yjnE34gW7Z qXPNY62TrKDK37aR3Z0IDtFyIMCwmX07bFA9WH9iZPsUL76Yt0mkfl6qFoiIPvHV hIKhgpCptS0jOoC1S7oK/2Hf6PzcXg== =kcPd -----END PGP SIGNATURE-----home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210216162036.tv7fvcv4jjd4rv6q>