diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index e57c67f3..372b0532 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -17,11 +17,7 @@ jobs: uses: actions/configure-pages@v5 - name: Build DocC run: | - swift package --allow-writing-to-package-directory \ - generate-documentation --target xtool --disable-indexing \ - --output-path docs - - echo "" > docs/index.html; + ./scripts/build-docs.sh - name: Upload artifact uses: actions/upload-pages-artifact@v3 with: diff --git a/Package.swift b/Package.swift index 8237c1a4..b83ca5e6 100644 --- a/Package.swift +++ b/Package.swift @@ -161,5 +161,8 @@ let package = Package( ], cSettings: cSettings ), + .executableTarget( + name: "XToolDocs" + ), ] ) diff --git a/Sources/xtool/Documentation.docc/Control.md b/Sources/XToolDocs/Documentation.docc/Control.md similarity index 100% rename from Sources/xtool/Documentation.docc/Control.md rename to Sources/XToolDocs/Documentation.docc/Control.md diff --git a/Sources/xtool/Documentation.docc/Documentation.md b/Sources/XToolDocs/Documentation.docc/Documentation.md similarity index 89% rename from Sources/xtool/Documentation.docc/Documentation.md rename to Sources/XToolDocs/Documentation.docc/Documentation.md index 7556e782..ad575175 100644 --- a/Sources/xtool/Documentation.docc/Documentation.md +++ b/Sources/XToolDocs/Documentation.docc/Documentation.md @@ -1,4 +1,8 @@ -# ``xtool`` +# ``XToolDocs`` + +@Metadata { + @DisplayName("xtool") +} Cross-platform Xcode replacement. diff --git a/Sources/xtool/Documentation.docc/First-app-code/build-1a.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/build-1a.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/build-1a.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/build-1a.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/build-1b.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/build-1b.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/build-1b.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/build-1b.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/build-2.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/build-2.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/build-2.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/build-2.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/build-3.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/build-3.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/build-3.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/build-3.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/edit-2.swift b/Sources/XToolDocs/Documentation.docc/First-app-code/edit-2.swift similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/edit-2.swift rename to Sources/XToolDocs/Documentation.docc/First-app-code/edit-2.swift diff --git a/Sources/xtool/Documentation.docc/First-app-code/edit-4.swift b/Sources/XToolDocs/Documentation.docc/First-app-code/edit-4.swift similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/edit-4.swift rename to Sources/XToolDocs/Documentation.docc/First-app-code/edit-4.swift diff --git a/Sources/xtool/Documentation.docc/First-app-code/rerun-5a.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/rerun-5a.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/rerun-5a.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/rerun-5a.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/rerun-5b.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/rerun-5b.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/rerun-5b.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/rerun-5b.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/rerun-6.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/rerun-6.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/rerun-6.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/rerun-6.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-1a.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-1a.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-1a.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-1a.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-1b.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-1b.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-1b.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-1b.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-2a.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-2a.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-2a.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-2a.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-2b.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-2b.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-2b.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-2b.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-3a.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-3a.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-3a.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-3a.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-3b.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-3b.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-3b.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-3b.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-4a.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-4a.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-4a.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-4a.sh diff --git a/Sources/xtool/Documentation.docc/First-app-code/template-4b.sh b/Sources/XToolDocs/Documentation.docc/First-app-code/template-4b.sh similarity index 100% rename from Sources/xtool/Documentation.docc/First-app-code/template-4b.sh rename to Sources/XToolDocs/Documentation.docc/First-app-code/template-4b.sh diff --git a/Sources/xtool/Documentation.docc/First-app.tutorial b/Sources/XToolDocs/Documentation.docc/First-app.tutorial similarity index 100% rename from Sources/xtool/Documentation.docc/First-app.tutorial rename to Sources/XToolDocs/Documentation.docc/First-app.tutorial diff --git a/Sources/xtool/Documentation.docc/Installation-Linux.md b/Sources/XToolDocs/Documentation.docc/Installation-Linux.md similarity index 100% rename from Sources/xtool/Documentation.docc/Installation-Linux.md rename to Sources/XToolDocs/Documentation.docc/Installation-Linux.md diff --git a/Sources/xtool/Documentation.docc/Installation-macOS.md b/Sources/XToolDocs/Documentation.docc/Installation-macOS.md similarity index 100% rename from Sources/xtool/Documentation.docc/Installation-macOS.md rename to Sources/XToolDocs/Documentation.docc/Installation-macOS.md diff --git a/Sources/xtool/Documentation.docc/Resources/Autocomplete.png b/Sources/XToolDocs/Documentation.docc/Resources/Autocomplete.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Autocomplete.png rename to Sources/XToolDocs/Documentation.docc/Resources/Autocomplete.png diff --git a/Sources/xtool/Documentation.docc/Resources/Cover.png b/Sources/XToolDocs/Documentation.docc/Resources/Cover.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Cover.png rename to Sources/XToolDocs/Documentation.docc/Resources/Cover.png diff --git a/Sources/xtool/Documentation.docc/Resources/Developer.PNG b/Sources/XToolDocs/Documentation.docc/Resources/Developer.PNG similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Developer.PNG rename to Sources/XToolDocs/Documentation.docc/Resources/Developer.PNG diff --git a/Sources/xtool/Documentation.docc/Resources/HelloWorld-Purple.png b/Sources/XToolDocs/Documentation.docc/Resources/HelloWorld-Purple.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/HelloWorld-Purple.png rename to Sources/XToolDocs/Documentation.docc/Resources/HelloWorld-Purple.png diff --git a/Sources/xtool/Documentation.docc/Resources/HelloWorld.png b/Sources/XToolDocs/Documentation.docc/Resources/HelloWorld.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/HelloWorld.png rename to Sources/XToolDocs/Documentation.docc/Resources/HelloWorld.png diff --git a/Sources/xtool/Documentation.docc/Resources/Home.png b/Sources/XToolDocs/Documentation.docc/Resources/Home.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Home.png rename to Sources/XToolDocs/Documentation.docc/Resources/Home.png diff --git a/Sources/xtool/Documentation.docc/Resources/Hover.png b/Sources/XToolDocs/Documentation.docc/Resources/Hover.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Hover.png rename to Sources/XToolDocs/Documentation.docc/Resources/Hover.png diff --git a/Sources/xtool/Documentation.docc/Resources/Hover2.png b/Sources/XToolDocs/Documentation.docc/Resources/Hover2.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Hover2.png rename to Sources/XToolDocs/Documentation.docc/Resources/Hover2.png diff --git a/Sources/xtool/Documentation.docc/Resources/SwiftExtension.png b/Sources/XToolDocs/Documentation.docc/Resources/SwiftExtension.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/SwiftExtension.png rename to Sources/XToolDocs/Documentation.docc/Resources/SwiftExtension.png diff --git a/Sources/xtool/Documentation.docc/Resources/Trust.png b/Sources/XToolDocs/Documentation.docc/Resources/Trust.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Trust.png rename to Sources/XToolDocs/Documentation.docc/Resources/Trust.png diff --git a/Sources/xtool/Documentation.docc/Resources/UntrustedDev.png b/Sources/XToolDocs/Documentation.docc/Resources/UntrustedDev.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/UntrustedDev.png rename to Sources/XToolDocs/Documentation.docc/Resources/UntrustedDev.png diff --git a/Sources/xtool/Documentation.docc/Resources/Verified.png b/Sources/XToolDocs/Documentation.docc/Resources/Verified.png similarity index 100% rename from Sources/xtool/Documentation.docc/Resources/Verified.png rename to Sources/XToolDocs/Documentation.docc/Resources/Verified.png diff --git a/Sources/xtool/Documentation.docc/ToC.tutorial b/Sources/XToolDocs/Documentation.docc/ToC.tutorial similarity index 100% rename from Sources/xtool/Documentation.docc/ToC.tutorial rename to Sources/XToolDocs/Documentation.docc/ToC.tutorial diff --git a/Sources/XToolDocs/main.swift b/Sources/XToolDocs/main.swift new file mode 100644 index 00000000..e69de29b diff --git a/scripts/build-docs.sh b/scripts/build-docs.sh new file mode 100755 index 00000000..bc2f60e7 --- /dev/null +++ b/scripts/build-docs.sh @@ -0,0 +1,9 @@ +#!/bin/bash + +set -euo pipefail + +rm -rf docs + +swift package --allow-writing-to-package-directory \ + generate-documentation --target XToolDocs --disable-indexing \ + --output-path docs