Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 20 Apr 2021 13:01:28 +0200
From:      Sergio Carlavilla <carlavilla@freebsd.org>
To:        Mateusz Piotrowski <0mp@freebsd.org>
Cc:        dev-commits-doc-all@freebsd.org, doc-committers@freebsd.org
Subject:   Re: git: bb4bdb25db - main - content/en: Use <<section>> for linking within a document
Message-ID:  <CAFwocyOSiZvLubMPDL3XoaT_iu=A4mfcocGEmvjHgZe28uXyxA@mail.gmail.com>
In-Reply-To: <202104201058.13KAwDdZ045873@gitrepo.freebsd.org>
References:  <202104201058.13KAwDdZ045873@gitrepo.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 20 Apr 2021 at 12:58, Mateusz Piotrowski <0mp@freebsd.org> wrote:

> The branch main has been updated by 0mp:
>
> URL:
> https://cgit.FreeBSD.org/doc/commit/?id=3Dbb4bdb25db841acd73da3ce543c964a=
fe49f7f63
>
> commit bb4bdb25db841acd73da3ce543c964afe49f7f63
> Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
> AuthorDate: 2021-04-20 10:49:32 +0000
> Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
> CommitDate: 2021-04-20 10:49:32 +0000
>
>     content/en: Use <<section>> for linking within a document
>
>     I've used the following script to locate all the cases where crossref
>     was used to link to a section within the same document:
>
>       grep -R crossref: | while read -r case; do
>           file=3D${case%%:*}
>           dir=3D${file%/*}
>           dir_name=3D${dir##*/}
>           line=3D${case##*:}
>           target_document=3D${line%%[*}
>           if [ "$dir_name" =3D "$target_document" ]; then
>               echo "$case"
>           fi
>       done
> ---
>  documentation/content/en/books/handbook/mirrors/_index.adoc | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc
> b/documentation/content/en/books/handbook/mirrors/_index.adoc
> index 6d1aaafa1d..940df19568 100644
> --- a/documentation/content/en/books/handbook/mirrors/_index.adoc
> +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc
> @@ -524,7 +524,7 @@ To update [.filename]#/usr/src# created in the exampl=
e
> above, use:
>
>  The update is much quicker than a checkout, only transferring files that
> have changed.
>
> -There are also external mirrors maintained by project members available,
> please refer to the crossref:mirrors[external-mirrors,External mirrors]
> section.
> +There are also external mirrors maintained by project members available,
> please refer to the <<external-mirrors>> section.
>
>  =3D=3D=3D SSH related information
>
> @@ -554,7 +554,7 @@ These are also published as SSHFP records in DNS.
>  =3D=3D=3D Web-based repository browser
>
>  The FreeBSD project currently uses cgit as the web-based repository
> browser: https://cgit.freebsd.org/.
> -The <https://cgit.freebsd.org/.-The>; URLs of indivirual repositories are
> listed crossref:mirrors[git-url-table,here].
> +The URLs of indivirual repositories are listed in <<git-url-table>>.
>
>  =3D=3D=3D For Users
>
> @@ -730,7 +730,7 @@ This section demonstrates how to install Subversion o=
n
> a FreeBSD system and use
>
>  FreeBSD systems older than 12._x_ do not have proper root certificates.
>  Those certificates allow Subversion to verify the identity of HTTPS
> repository server.
> -Installation instructions are described in
> crossref:mirrors[git-ssl-certificates,=E2=80=9CRoot SSL Certificates=E2=
=80=9D].
> +Installation instructions are described in <<git-ssl-certificates>>.
>
>  [[svn-svnlite]]
>  =3D=3D=3D Svnlite
>
Hi,

Nice script! Thanks!



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAFwocyOSiZvLubMPDL3XoaT_iu=A4mfcocGEmvjHgZe28uXyxA>