[tracker/wip/carlosg/test] ci: Change src/dest dirs for hotdoc documentation




commit d1fff9a2669600e502280ee6e11e6616fb8937d6
Author: Carlos Garnacho <carlosg gnome org>
Date:   Sun Aug 29 20:24:29 2021 +0200

    ci: Change src/dest dirs for hotdoc documentation
    
    This is now generated/installed in different paths, and we want
    to remove the "api-preview" bits of the target URL. Change these
    so the documentation is correctly picked up, and looks "official".

 .gitlab-ci.yml                 |  2 +-
 docs/website/build.py          | 18 +++++++++---------
 docs/website/docs/developer.md | 34 ----------------------------------
 3 files changed, 10 insertions(+), 44 deletions(-)
---
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 0fb0d6515..4e071cfc5 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -337,7 +337,7 @@ test-website:
     - |
       export tracker_commit=$CI_COMMIT_SHA
       export tracker_miners_commit=$(git -C ./extra/tracker-miners rev-parse HEAD)
-      ./docs/website/build.py --output=website --api-docs="$install_prefix/share/gtk-doc/html" 
--tracker-commit=${tracker_commit} --man-pages ./docs/manpages/*.txt 
./extra/tracker-miners/docs/manpages/*.txt
+      ./docs/website/build.py --output=website 
--api-docs="./docs/reference/libtracker-sparql/Tracker-doc/html" --tracker-commit=${tracker_commit} 
--man-pages ./docs/manpages/*.txt ./extra/tracker-miners/docs/manpages/*.txt
   artifacts:
     paths:
       - website
diff --git a/docs/website/build.py b/docs/website/build.py
index 629c07b33..294a6eaab 100755
--- a/docs/website/build.py
+++ b/docs/website/build.py
@@ -192,15 +192,15 @@ def main():
     apidocs_src = pathlib.Path(args.api_docs)
 
     log.info("Copying API reference documentation from %s", apidocs_src)
-    apidocs_dest = output_path.joinpath('docs/api-preview')
-    apidocs_dest.mkdir(parents=True)
-    for name in ['libtracker-sparql-3', 'ontology-3']:
-        src = apidocs_src.joinpath(name)
-        dest  = apidocs_dest.joinpath(name)
-        if not src.exists():
-            raise RuntimeError("Expected path {} doesn't exist.".format(src))
-        log.info("  - Copying %s to %s (%i files)", src, dest, len(list(src.iterdir())))
-        shutil.copytree(src, dest)
+    apidocs_dest = output_path.joinpath('docs/developer/')
+    apidocs_dest.mkdir(parents=True, exist_ok=True)
+
+    src = apidocs_src
+    dest  = apidocs_dest
+    if not src.exists():
+        raise RuntimeError("Expected path {} doesn't exist.".format(src))
+    log.info("  - Copying %s to %s (%i files)", src, dest, len(list(src.iterdir())))
+    shutil.copytree(src, dest)
 
     log.info("Adding preview header to API reference documentation")
     text = apidocs_header(args.tracker_commit)
diff --git a/docs/website/docs/developer.md b/docs/website/docs/developer.md
index b685541ad..4796167e6 100644
--- a/docs/website/docs/developer.md
+++ b/docs/website/docs/developer.md
@@ -1,35 +1 @@
 # Developer Documentation
-    
-Application and platform developers using Tracker will interact with Tracker
-using one or more of the shared libraries it provides:
-
- * [libtracker-sparql](https://developer.gnome.org/libtracker-sparql/stable/) is
-   used to read and write data from the Tracker store using SPARQL.
- * [libtracker-control](https://developer.gnome.org/libtracker-control/stable/),
-   is used to manage Tracker daemons.
- * [libtracker-miner](https://developer.gnome.org/libtracker-miner/stable/) can
-   be used if you want to implement a new data provider while reusing existing
-   Tracker code.
-
-WARNING: The documention linked above is for out of date verions of Tracker 2.x.
-This is due to an [infrastructure
-issue](https://gitlab.gnome.org/Infrastructure/library-web/issues/50). See also
-[this bug](https://gitlab.gnome.org/GNOME/tracker/-/issues/100).
-
-The following documentation may be useful:
-
- * [Tracker ontology documentation](https://developer.gnome.org/ontology/stable/).
- * [Tracker documentation on wiki.gnome.org](https://wiki.gnome.org/Projects/Tracker).
-
-For working on Tracker itself, read the [HACKING.md
-file](https://gitlab.gnome.org/GNOME/tracker/-/blob/master/HACKING.md).
-
-## Preview Documentation
-
-We provide an online version of the documentation for the latest in-development version
-of Tracker. You can browse it here:
-
-  * [libtracker-sparql](../api-preview/libtracker-sparql-3/)
-  * [ontology](../api-preview/ontology-3/)
-
-Be aware that some libraries from Tracker 2.0 will not be available for Tracker 3.0.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]