Test building documentation

issue11367
review397811002

.drone.yml

@@ -30,6 +30,11 @@ pipeline:
             - pip install twine
             - python setup.py sdist
             - twine check dist/*
+    check_doc:
+        image: ${IMAGE]
+        commands:
+            - pip install sphinx
+            - python -m sphinx -T -E -W -n -b html doc _build/html
 
 services:
     postgresql:

doc/design.rst

@@ -4,13 +4,13 @@ Design
 
 The *Web Shop Shopify Module* introduces some new concepts.
 
-.. _model-web.shop.shopify_identifier
+.. _model-web.shop.shopify_identifier:
 
 Shopify Identifier
 ==================
 
 A *Shopify Identifier* stores the Shopify ID for records from other models for
-each different `Web Shop <web_shop:model-web.shop>`.
+each different :doc:`Web Shop <web_shop:index>`.
 
 .. seealso::
 
@@ -21,16 +21,16 @@ each different `Web Shop <web_shop:model-web.shop>`.
       .. |Administration --> Models --> Shopify Identifiers| replace:: :menuselection:`Administration --> Models --> Shopify Identifiers`
       __ https://demo.tryton.org/model/web.shop.shopify_identifier
 
-.. model-web.shop.shopify_payment_journal
+.. _model-web.shop.shopify_payment_journal:
 
 Shopify Payment Journal
 =======================
 
 The *Shopify Payment Journal* stores the rules which are used to determine on
-which `Payment Journal <account_payment:model-account.payment.journal>` the
-transactions are entered.
+which :doc:`Payment Journal <account_payment:index>` the transactions are
+entered.
 
-.. model-stock.shipment.shopify_identifier
+.. _model-stock.shipment.shopify_identifier:
 
 Shopify Shipment Identifier
 ===========================
@@ -48,7 +48,7 @@ for each `Sale <sale:model-sale.sale>`.
       __ https://demo.tryton.org/model/stock.shipment.shopify_identifier
 
 
-.. model-web.shop.shopify_inventory_item
+.. _model-web.shop.shopify_inventory_item:
 
 Shopify Inventory Item
 ======================

doc/index.rst

@@ -3,9 +3,9 @@ Web Shop Shopify Module
 #######################
 
 The *Web Shop Shopify Module* provides a way to manage `Shopify
-<https://www.shopify.com/>` stores.
+<https://www.shopify.com/>`_ stores.
 It uploads products, variants and collections to Shopify, and downloads orders,
-transactions and creates fulfillments.
+transactions and creates fulfilments.
 
 .. toctree::
    :maxdepth: 2

doc/usage.rst

@@ -23,7 +23,7 @@ store with, as a minimum, the following permissions:
 
 You also need to copy the password that is generated.
 
-When setting the `Web Shop <web_shop:model-web.shop>`'s type to  "Shopify", you
+When setting the :doc:`Web Shop <web_shop:index>`'s type to  "Shopify", you
 must fill in the "Shop URL" (e.g. ``https://<store-name>.myshopify.com``) and
 the "Password" with the copied one.