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>
next in thread | previous in thread | raw e-mail | index | archive | help
--mudmja3czgfbpjrd Content-Type: text/plain; charset=utf-8; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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 p= ut >> 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 Abo= ut >> 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=E2=80=99re using? > >If you execute =E2=80=9Cmake run=E2=80=9D this should update the changes a= utomatically. > >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=20 on a host that isn't localhost, as I run it on a server that's a bit=20 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=20 documentation) Alter whatever it is I wanna change, and save the file. Hugo should=20 rebuild the changed part (although this doesn't always work, possibly=20 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=20 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`= =20 and throw the install target at it afterwards (you'll need to be in the=20 tree for 14-CURRENT for this), you can use git arc (and it's manual=20 page, adopted to mdoc(7) by yours truly) to upload directly to=20 reviews.freebsd.org. I hope this helps, but please feel free to reach out (preferably on=20 #bsddocs on IRC) if necessary. Also, yes, I do intend to add this to the FDP, but it could be added by=20 someone else too. *hint hint, wink wink, nudge nudge* Yours, Daniel Ebdrup Jensen --mudmja3czgfbpjrd Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAr8NRfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87rnMwf/azssfREk91t76N0XXNPbMKaCb18cDXk7oAgo8DKNc8IGUDnXBy3xkZKD SQ6cVtumyhUtElrVlfIjTKMKKs6KzUywrDt38VpVyrYjgTrpjfgRO7MCCOwGjo0u vutVOhSIve+WR+Kk67ZRzbnNsuTQN7ZiEDhAkX/GcsqzwowI8otZMyIUS4rZ2WkA tRDuaYWwHcbTUe8dZWlEFB1CFrXlEDqDykH+dmwDqTgEkT4OYQnni1yjnE34gW7Z qXPNY62TrKDK37aR3Z0IDtFyIMCwmX07bFA9WH9iZPsUL76Yt0mkfl6qFoiIPvHV hIKhgpCptS0jOoC1S7oK/2Hf6PzcXg== =kcPd -----END PGP SIGNATURE----- --mudmja3czgfbpjrd--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210216162036.tv7fvcv4jjd4rv6q>