[Git][ghc/ghc][wip/T24651] Fix documentation preview from doc-tarball job

Teo Camarasu (@teo) gitlab at gitlab.haskell.org
Mon Apr 15 15:27:37 UTC 2024



Teo Camarasu pushed to branch wip/T24651 at Glasgow Haskell Compiler / GHC


Commits:
5df1ec29 by Teo Camarasu at 2024-04-15T16:17:55+01:00
Fix documentation preview from doc-tarball job

- Include all the .html files and assets in the job artefacts
- Include all the .pdf files in the job artefacts
- Mark the artefact as an "exposed" artefact meaning it turns up in the
  UI.

Resolves #24651

- - - - -


2 changed files:

- .gitlab-ci.yml
- distrib/mkDocs/mkDocs


Changes:

=====================================
.gitlab-ci.yml
=====================================
@@ -557,12 +557,17 @@ doc-tarball:
     LINUX_BINDIST: "ghc-x86_64-linux-deb10.tar.xz"
     WINDOWS_BINDIST: "ghc-x86_64-windows.tar.xz"
   artifacts:
+    expose_as: "Documentation Preview"
     paths:
       - haddock.html.tar.xz
+      - docs/haddock/
       - libraries.html.tar.xz
+      - docs/libraries/
       - users_guide.html.tar.xz
-      - index.html
-      - "*.pdf"
+      - docs/users_guide/
+      - docs/index.html
+      - Haddock.pdf
+      - users_guide.pdf
   script:
     - |
       mv "ghc-x86_64-linux-deb10-numa-slow-validate.tar.xz" "$LINUX_BINDIST" \
@@ -582,8 +587,8 @@ doc-tarball:
       fi
     - rm -Rf docs
     - bash -ex distrib/mkDocs/mkDocs $LINUX_BINDIST $WINDOWS_BINDIST
+    - mv docs/*.tar.xz docs/*.pdf .
     - ls -lh
-    - mv docs/*.tar.xz docs/index.html .
 
 hackage-doc-tarball:
   stage: packaging


=====================================
distrib/mkDocs/mkDocs
=====================================
@@ -43,7 +43,7 @@ do
     dir=${i%*/}
     tar -Jcf ../../../../../$dir.html.tar.xz $dir
 done
-mv index.html ../../../../..
+mv index.html users_guide libraries ../../../../..
 cd ..
 mv ./*.pdf ../../../.. || \
     die "failed to find PDFs"



View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/commit/5df1ec294c26182a890f670df8e27271b6b8b574

-- 
View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/commit/5df1ec294c26182a890f670df8e27271b6b8b574
You're receiving this email because of your account on gitlab.haskell.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/ghc-commits/attachments/20240415/a79c369c/attachment-0001.html>


More information about the ghc-commits mailing list