Date: Mon, 11 Apr 2022 20:43:46 -0300 From: "Danilo G. Baio" <dbaio@FreeBSD.org> To: freebsd-hubs@FreeBSD.org Subject: Re: articles/hubs: Update WWW mirroring section Message-ID: <20220411234346.mw4voizwjqrecosy@t480.local> In-Reply-To: <202204112333.23BNXlUW025334@gitrepo.freebsd.org> References: <202204112333.23BNXlUW025334@gitrepo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--7jqpdw3cnduiwgnn Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable FYI This just reflects the reality. https://docs.freebsd.org/en/articles/hubs/#mirror-www On Mon, Apr 11, 2022 at 11:33:47PM +0000, Danilo G. Baio wrote: > The branch main has been updated by dbaio: >=20 > URL: https://cgit.FreeBSD.org/doc/commit/?id=3D68b40e34553002f86a41d00728= 1e1a25422e7f4a >=20 > commit 68b40e34553002f86a41d007281e1a25422e7f4a > Author: Danilo G. Baio <dbaio@FreeBSD.org> > AuthorDate: 2022-03-05 13:14:59 +0000 > Commit: Danilo G. Baio <dbaio@FreeBSD.org> > CommitDate: 2022-04-11 23:29:26 +0000 >=20 > articles/hubs: Update WWW mirroring section > =20 > Differential Revision: https://reviews.freebsd.org/D34454 > --- > documentation/content/en/articles/hubs/_index.adoc | 23 ++++++++++++++++= ++++-- > 1 file changed, 21 insertions(+), 2 deletions(-) >=20 > diff --git a/documentation/content/en/articles/hubs/_index.adoc b/documen= tation/content/en/articles/hubs/_index.adoc > index 1e2c9da25a..9c5bf2506e 100644 > --- a/documentation/content/en/articles/hubs/_index.adoc > +++ b/documentation/content/en/articles/hubs/_index.adoc > @@ -214,14 +214,33 @@ If you sync the whole module (unlike subdirectories= ), be aware that the module-d > [[mirror-www]] > =3D=3D=3D Mirroring the WWW Pages > =20 > -The FreeBSD website should only be mirrored via rsync. > +[WARNING] > +=3D=3D=3D=3D > +Since doc migration to Hugo/Asciidoctor on 2021-01-25, mirroring the web= site with rsync no longer works. > +=3D=3D=3D=3D > + > +There are ongoing studies to implement a website mirror with the extref:= {handbook}mirrors/[official infrastructure]. > + > +For the former website mirrors, a way to achieve mirroring the website t= oday is building the website locally with the corresponding address it will= be hosted. > + > +[source,shell] > +.... > +% cd website && env HUGO_baseURL=3D"https://www.XX.freebsd.org/" make > +.... > =20 > -A command line to mirror the FreeBSD web site might look like: > +Check for more details about the build tools on extref:{fdp-primer}overv= iew/[FreeBSD Documentation Project Primer for New Contributors, overview-qu= ick-start] book. > =20 > +//// > [source,shell] > .... > % rsync -vaHz --delete rsync://bit0.us-west.freebsd.org/FreeBSD-www-data= / /usr/local/www/ > .... > +//// > + > +[NOTE] > +=3D=3D=3D=3D > +Notice the website was split into www.FreeBSD.org and docs.FreeBSD.org, = and there are links between them; plus, at this moment, `HUGO_baseURL` vari= able won't cover all links, this way, mirroring the website is discouraged. > +=3D=3D=3D=3D > =20 > [[mirror-pkgs]] > =3D=3D=3D Mirroring Packages >=20 Regards. --=20 Danilo G. Baio (dbaio) --7jqpdw3cnduiwgnn Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEEORj0UTsjzCy+enIkmpN7LfMuiNcFAmJUvS4ACgkQmpN7LfMu iNfKmhAAugNqq2x3fvRteqAKkzTyqK5aSduXH3JeOOZaVOLzaw5Xorc3SImz90A/ OJisO+AdHyP/kumgVU5UzmiHFimWtn4qocOLJGZwDExa4psYlw/7M7tEOe1tqVLM xpBAZlFZZLymvCEZs4lDsTDjCKqqOlFEmgS1XmC6bQm5ZHool07WZeeWB8O3rxXL RL1Qo70FQjn6JqNUm1YSrqC3CXO8CkVcZLm/+jo6jOZAAOjoOTQErLdobeYoQw33 pGWhukxbXoJ+s7H/UoGdNW9vO1x5xCHGksXDdtkR2EXHYONAFuyhesMGgsuA8FXo tnETplgz2Vz6/WbdtjEpgBAojW4sm61W+S9V9nuiRj935W5GXP7uOgU+xDBSLo9Q wE3STmXbIzTioKKlYHbBFeCUAtbddOwIhOmBryXu1Qo/DPvdOceRABaeW/iy7uP5 JYyU5Y3EpnDI6IKCXcUzI1fyM5rC+iPunLcbrsdM/ORRW1oO4b+V7essdAFkQGaE YHKNqFBytRCHCtMX1KKCg3lLZIKaSjBA8GBW1pqSEncjWIV/Abmac18zKcvgHxV+ T9Yg88sQR+j4URClSLmj5Gar8LScYLdPkZqnEpY+4to02+c4SP7TAelRin1Gj7RG BgAo1gPtEjYaV+++J6pzXPfUjkROHOV0i5ixh4LoqW4U+4N6b1Q= =sKSZ -----END PGP SIGNATURE----- --7jqpdw3cnduiwgnn--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20220411234346.mw4voizwjqrecosy>