From 283ed72d487ed78d4f8e0fcc17f635d6c212b7c6 Mon Sep 17 00:00:00 2001 From: Nicolas Dechesne Date: Thu, 30 Jul 2020 11:00:01 +0200 Subject: sphinx: add links for Yocto project website In DocBook, variables are used to create custom links (note that it is not consistent everywhere, since some web addresses are still hardcoded), such as YOCTO_HOME_URL, YOCTO_GIT_URL, YOCTO_WIKI_URL, YOCTO_BUGS_URL and YOCTO_DL_URL.. In Sphinx they are replaced with extlinks. (From yocto-docs rev: d25f3095a9d29a3355581d0743f27b2a423ad580) Signed-off-by: Nicolas Dechesne Signed-off-by: Richard Purdie --- .../dev-manual/dev-manual-common-tasks.rst | 35 ++++++++++------------ documentation/dev-manual/dev-manual-intro.rst | 4 +-- documentation/dev-manual/dev-manual-start.rst | 21 +++++++------ 3 files changed, 28 insertions(+), 32 deletions(-) (limited to 'documentation/dev-manual') diff --git a/documentation/dev-manual/dev-manual-common-tasks.rst b/documentation/dev-manual/dev-manual-common-tasks.rst index 29a94b9a84..0703f3ebc8 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.rst +++ b/documentation/dev-manual/dev-manual-common-tasks.rst @@ -68,8 +68,7 @@ Follow these general steps to create your layer without using tools: ``conf`` directory and then modify the file as needed. The ``meta-yocto-bsp/conf/layer.conf`` file in the Yocto Project - `Source - Repositories <&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/meta-yocto-bsp/conf>`__ + :yocto_git:`Source Repositories ` demonstrates the required syntax. For your layer, you need to replace "yoctobsp" with a unique identifier for your layer (e.g. "machinexyz" for a layer named "meta-machinexyz"): # We have a conf and classes @@ -120,7 +119,7 @@ Follow these general steps to create your layer without using tools: Lists all layers on which this layer depends (if any). - :term:`LAYERSERIES_COMPAT`: - Lists the `Yocto Project <&YOCTO_WIKI_URL;/wiki/Releases>`__ + Lists the :yocto_wiki:`Yocto Project ` releases for which the current version is compatible. This variable is a good way to indicate if your particular layer is current. @@ -4001,9 +4000,9 @@ your tunings to best consider build times and package feed maintenance. higher levels noted earlier can be useful. For example, consider how NXP (formerly Freescale) allows for the easy reuse of binary packages in their layer - ```meta-freescale`` <&YOCTO_GIT_URL;/cgit/cgit.cgi/meta-freescale/>`__. + :yocto_git:`meta-freescale `. In this example, the - ```fsl-dynamic-packagearch`` <&YOCTO_GIT_URL;/cgit/cgit.cgi/meta-freescale/tree/classes/fsl-dynamic-packagearch.bbclass>`__ + :yocto_git:`fsl-dynamic-packagearch ` class shares GPU packages for i.MX53 boards because all boards share the AMD GPU. The i.MX6-based boards can do the same because all boards share the Vivante GPU. This class inspects the BitBake @@ -5058,7 +5057,7 @@ partition. Source plugins are subclasses defined in plugin files. As shipped, the Yocto Project provides several plugin files. You can see the source plugin files that ship with the Yocto Project -`here <&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/scripts/lib/wic/plugins/source>`__. +:yocto_git:`here `. Each of these plugin files contains source plugins that are designed to populate a specific Wic image partition. @@ -5591,8 +5590,8 @@ Tools for Hardening Your Image ------------------------------ The Yocto Project provides tools for making your image more secure. You -can find these tools in the ``meta-security`` layer of the `Yocto -Project Source Repositories <&YOCTO_GIT_URL;>`__. +can find these tools in the ``meta-security`` layer of the +:yocto_git:`Yocto Project Source Repositories <>`. Creating Your Own Distribution ============================== @@ -5872,7 +5871,7 @@ the following: build system uses this string to help define the value of ``PV`` when the source code revision needs to be included in it. -- `PR Service `__: A +- :yocto_wiki:`PR Service `: A network-based service that helps automate keeping package feeds compatible with existing package manager applications such as RPM, APT, and OPKG. @@ -6574,7 +6573,7 @@ testname where the result can be ``PASS``, ``FAIL``, or ``SKIP``, and the testname can be any identifying string. For a list of Yocto Project recipes that are already enabled with ptest, -see the `Ptest `__ wiki page. +see the :yocto_wiki:`Ptest ` wiki page. .. note:: @@ -9209,10 +9208,9 @@ Here are some other tips that you might find useful: indicate that the documentation should be extended or improved. In such cases, consider filing a documentation bug using the Yocto Project implementation of - `Bugzilla `__. For information on + :yocto_bugs:`Bugzilla <>`. For information on how to submit a bug against the Yocto Project, see the Yocto Project - Bugzilla `wiki - page <&YOCTO_WIKI_URL;/wiki/Bugzilla_Configuration_and_Bug_Tracking>`__ + Bugzilla :yocto_wiki:`wiki page ` and the "`Submitting a Defect Against the Yocto Project <#submitting-a-defect-against-the-yocto-project>`__" section. @@ -9241,13 +9239,12 @@ against the Yocto Project. For additional information on this implementation of Bugzilla see the "`Yocto Project Bugzilla <&YOCTO_DOCS_REF_URL;#resources-bugtracker>`__" section in the Yocto Project Reference Manual. For more detail on any of the following -steps, see the Yocto Project `Bugzilla wiki -page <&YOCTO_WIKI_URL;/wiki/Bugzilla_Configuration_and_Bug_Tracking>`__. +steps, see the Yocto Project +:yocto_wiki:`Bugzilla wiki page `. Use the following general steps to submit a bug" -1. Open the Yocto Project implementation of - `Bugzilla <&YOCTO_BUGZILLA_URL;>`__. +1. Open the Yocto Project implementation of :yocto_bugs:`Bugzilla <>`. 2. Click "File a Bug" to enter a new bug. @@ -9365,8 +9362,8 @@ concepts on working in the Yocto Project development environment. Two commonly used testing repositories exist for OpenEmbedded-Core: - *"ross/mut" branch:* The "mut" (master-under-test) tree exists in the - ``poky-contrib`` repository in the `Yocto Project source - repositories <&YOCTO_GIT_URL;>`__. + ``poky-contrib`` repository in the + :yocto_git:`Yocto Project source repositories <>`. - *"master-next" branch:* This branch is part of the main "poky" repository in the Yocto Project source repositories. diff --git a/documentation/dev-manual/dev-manual-intro.rst b/documentation/dev-manual/dev-manual-intro.rst index 492d3db82a..1dc552c750 100644 --- a/documentation/dev-manual/dev-manual-intro.rst +++ b/documentation/dev-manual/dev-manual-intro.rst @@ -53,8 +53,8 @@ Other Information Because this manual presents information for many different topics, supplemental information is recommended for full comprehension. For -introductory information on the Yocto Project, see the `Yocto Project -Website <&YOCTO_HOME_URL;>`__. If you want to build an image with no +introductory information on the Yocto Project, see the +:yocto_home:`Yocto Project Website <>`. If you want to build an image with no knowledge of Yocto Project as a way of quickly testing it out, see the `Yocto Project Quick Build <&YOCTO_DOCS_BRIEF_URL;>`__ document. diff --git a/documentation/dev-manual/dev-manual-start.rst b/documentation/dev-manual/dev-manual-start.rst index 81fa7847e6..884d1286ef 100644 --- a/documentation/dev-manual/dev-manual-start.rst +++ b/documentation/dev-manual/dev-manual-start.rst @@ -92,7 +92,7 @@ particular working environment and set of practices. It is relatively easy to set up Git services and create infrastructure like - `http://git.yoctoproject.org <&YOCTO_GIT_URL;>`__, which is based on + :yocto_git:`http://git.yoctoproject.org <>`, which is based on server software called ``gitolite`` with ``cgit`` being used to generate the web interface that lets you view the repositories. The ``gitolite`` software identifies users using SSH keys and allows @@ -322,8 +322,7 @@ Project Build Host: validation and their status, see the "`Supported Linux Distributions <&YOCTO_DOCS_REF_URL;#detailed-supported-distros>`__" section in the Yocto Project Reference Manual and the wiki page at - `Distribution - Support <&YOCTO_WIKI_URL;/wiki/Distribution_Support>`__. + :yocto_wiki:`Distribution Support `. 2. *Have Enough Free Memory:* Your system should have at least 50 Gbytes of free disk space for building images. @@ -598,14 +597,14 @@ Working from a copy of the upstream Yocto Project `Source Repositories <&YOCTO_DOCS_OM_URL;#source-repositories>`__ is the preferred method for obtaining and using a Yocto Project release. You can view the Yocto Project Source Repositories at -` <&YOCTO_GIT_URL;>`__. In particular, you can find the ``poky`` -repository at ` `__. +:yocto_git:`/`. In particular, you can find the ``poky`` +repository at :yocto_git:`/cgit.cgi/poky`. Use the following procedure to locate the latest upstream copy of the ``poky`` Git repository: 1. *Access Repositories:* Open a browser and go to - ` <&YOCTO_GIT_URL;>`__ to access the GUI-based interface into the + :yocto_git:`/` to access the GUI-based interface into the Yocto Project source repositories. 2. *Select the Repository:* Click on the repository in which you are @@ -614,7 +613,7 @@ Use the following procedure to locate the latest upstream copy of the 3. *Find the URL Used to Clone the Repository:* At the bottom of the page, note the URL used to `clone <&YOCTO_DOCS_OM_URL;#git-commands-clone>`__ that repository - (e.g. ``YOCTO_GIT_URL/poky``). + (e.g. :yocto_git:`/git/poky`). .. note:: @@ -642,7 +641,7 @@ of a given component. Follow these steps to locate and download a particular tarball: 1. *Access the Index of Releases:* Open a browser and go to - ` <&YOCTO_DL_URL;/releases>`__ to access the Index of Releases. The + :yocto_dl:`Index of Releases `. The list represents released components (e.g. ``bitbake``, ``sato``, and so on). @@ -670,7 +669,7 @@ Follow these steps to locate and download a particular tarball: Using the Downloads Page ------------------------ -The `Yocto Project Website <&YOCTO_HOME_URL;>`__ uses a "DOWNLOADS" page +The :yocto_home:`Yocto Project Website <>` uses a "DOWNLOADS" page from which you can locate and download tarballs of any Yocto Project release. Rather than Git repositories, these files represent snapshot tarballs similar to the tarballs located in the Index of Releases @@ -684,8 +683,8 @@ Releases <#accessing-index-of-releases>`__" section. repository. The procedure in this section exists should you desire a tarball snapshot of any given component. -1. *Go to the Yocto Project Website:* Open The `Yocto Project - Website <&YOCTO_HOME_URL;>`__ in your browser. +1. *Go to the Yocto Project Website:* Open The + :yocto_home:`Yocto Project Website <>` in your browser. 2. *Get to the Downloads Area:* Select the "DOWNLOADS" item from the pull-down "SOFTWARE" tab menu near the top of the page. -- cgit v1.2.3-54-g00ecf