Fixed broken documentation links. (#93)

Nadegamra · web-flow · commit c3d086ab3545 · 2025-04-04T16:58:35.000+03:00
* Enabled relative paths in docsify. Switched to using relative paths in most `/docs` pages.
* Added alias for paths in docsify in order to make paths matching `/docs/.*` resolve to `/.*`. This makes absolute paths in docsify match the absolute paths in repository. Updated absolute paths in `/docs` accordingly.
diff --git a/docs/_sidebar.md b/docs/_sidebar.md
@@ -1,61 +1,62 @@
-* [iTwin CLI Manual](/)
-* [Quickstart](/quickstart.md)
-* [Workflows](workflows/overview.md)
+* [iTwin CLI Manual](/docs/)
+* [Quickstart](/docs/quickstart.md)
+* [Workflows](/docs/workflows/overview.md)
 
 <hr style="margin: 1em 5em 1em 1em; opacity: 0.1;">
 
-* [itp](itp.md)
-* [options](options.md)
-* [auth](auth/overview.md)
-  * [login](auth/login.md)
-  * [logout](auth/logout.md)
-* [api](api.md)
-* [itwin](itwin/overview.md)
-  * [create](itwin/create.md)
-  * [update](itwin/update.md)
-  * [delete](itwin/delete.md)
-  * [info](itwin/info.md)
-  * [list](itwin/list.md)
-  * [repository](itwin/repository/overview.md)
-* [imodel](imodel/overview.md)
-  * [create](imodel/create.md)
-  * [populate](imodel/populate.md)
-  * [update](imodel/update.md)
-  * [delete](imodel/delete.md)
-  * [info](imodel/info.md)
-  * [list](imodel/list.md)
-  * [view](imodel/view/overview.md)
-    * [cesium-sandcastle](imodel/view/cesium-sandcastle.md)
-  * [changeset](imodel/changeset/overview.md)
-  * [named-version](imodel/named-version/overview.md)
-  * [connection](imodel/connection/overview.md)
-    * [run](imodel/connection/run/overview.md)
-    * [sourcefile](imodel/connection/sourcefile/overview.md)
-* [changed-elements](changed-elements/overview.md)
-  * [enable](changed-elements/enable.md)
-  * [disable](changed-elements/disable.md)
-  * [info](changed-elements/info.md)
-  * [changesets](changed-elements/changesets.md)
-  * [comparison](changed-elements/comparison.md)
-* [storage](storage/overview.md)
-  * [root-folder](storage/root-folder.md)
-  * [file](storage/file/overview.md)
-  * [folder](storage/folder/overview.md)
-* [user](user/overview.md)
-  * [me](user/me.md)
-  * [info](user/info.md)
-  * [search](user/search.md)
-* [access-control](access-control/overview.md)
-  * [permissions](access-control/permissions/overview.md)
-  * [role](access-control/role/overview.md)
-  * [group](access-control/group/overview.md)
-  * [member](access-control/member/overview.md)
-    * [group](access-control/member/group/overview.md)
-    * [owner](access-control/member/owner/overview.md)
-    * [user](access-control/member/user/overview.md)
+* [itp](/docs/itp.md)
+* [options](/docs/options.md)
+* [auth](/docs/auth/overview.md)
+  * [info](/docs/auth/info.md) 
+  * [login](/docs/auth/login.md)
+  * [logout](/docs/auth/logout.md)
+* [api](/docs/api.md)
+* [itwin](/docs/itwin/overview.md)
+  * [create](/docs/itwin/create.md)
+  * [update](/docs/itwin/update.md)
+  * [delete](/docs/itwin/delete.md)
+  * [info](/docs/itwin/info.md)
+  * [list](/docs/itwin/list.md)
+  * [repository](/docs/itwin/repository/overview.md)
+* [imodel](/docs/imodel/overview.md)
+  * [create](/docs/imodel/create.md)
+  * [populate](/docs/imodel/populate.md)
+  * [update](/docs/imodel/update.md)
+  * [delete](/docs/imodel/delete.md)
+  * [info](/docs/imodel/info.md)
+  * [list](/docs/imodel/list.md)
+  * [view](/docs/imodel/view/overview.md)
+    * [cesium-sandcastle](/docs/imodel/view/cesium-sandcastle.md)
+  * [changeset](/docs/imodel/changeset/overview.md)
+  * [named-version](/docs/imodel/named-version/overview.md)
+  * [connection](/docs/imodel/connection/overview.md)
+    * [run](/docs/imodel/connection/run/overview.md)
+    * [sourcefile](/docs/imodel/connection/sourcefile/overview.md)
+* [changed-elements](/docs/changed-elements/overview.md)
+  * [enable](/docs/changed-elements/enable.md)
+  * [disable](/docs/changed-elements/disable.md)
+  * [info](/docs/changed-elements/info.md)
+  * [changesets](/docs/changed-elements/changesets.md)
+  * [comparison](/docs/changed-elements/comparison.md)
+* [storage](/docs/storage/overview.md)
+  * [root-folder](/docs/storage/root-folder.md)
+  * [file](/docs/storage/file/overview.md)
+  * [folder](/docs/storage/folder/overview.md)
+* [user](/docs/user/overview.md)
+  * [me](/docs/user/me.md)
+  * [info](/docs/user/info.md)
+  * [search](/docs/user/search.md)
+* [access-control](/docs/access-control/overview.md)
+  * [permissions](/docs/access-control/permissions/overview.md)
+  * [role](/docs/access-control/role/overview.md)
+  * [group](/docs/access-control/group/overview.md)
+  * [member](/docs/access-control/member/overview.md)
+    * [group](/docs/access-control/member/group/overview.md)
+    * [owner](/docs/access-control/member/owner/overview.md)
+    * [user](/docs/access-control/member/user/overview.md)
 
 <hr style="margin: 1em 5em 1em 1em; opacity: 0.1;">
 
-* [Command Workflows](command-workflows/overview.md)
-  * [iModel Populate](command-workflows/imodel-populate.md)
-  * [Cesium Sandcastle Export](command-workflows/cesium-sandcastle.md)
+* [Command Workflows](/docs/command-workflows/overview.md)
+  * [iModel Populate](/docs/command-workflows/imodel-populate.md)
+  * [Cesium Sandcastle Export](/docs/command-workflows/cesium-sandcastle.md)
diff --git a/docs/access-control/group/overview.md b/docs/access-control/group/overview.md
@@ -4,8 +4,8 @@ Manage iTwin access control groups.
 
 ## Available Commands
 
-- [itp access-control group create](access-control/group/create.md)
-- [itp access-control group update](access-control/group/update.md)
-- [itp access-control group delete](access-control/group/delete.md)
-- [itp access-control group info](access-control/group/info.md)
-- [itp access-control group list](access-control/group/list.md)
+- [itp access-control group create](create.md)
+- [itp access-control group update](update.md)
+- [itp access-control group delete](delete.md)
+- [itp access-control group info](info.md)
+- [itp access-control group list](list.md)
diff --git a/docs/access-control/member/group/overview.md b/docs/access-control/member/group/overview.md
@@ -4,8 +4,8 @@ Manage groups that can access an iTwin.
 
 ## Available Commands
 
-- [itp access-control member group add](access-control/member/group/add.md)
-- [itp access-control member group update](access-control/member/group/update.md)
-- [itp access-control member group delete](access-control/member/group/delete.md)
-- [itp access-control member group info](access-control/member/group/info.md)
-- [itp access-control member group list](access-control/member/group/list.md)
+- [itp access-control member group add](add.md)
+- [itp access-control member group update](update.md)
+- [itp access-control member group delete](delete.md)
+- [itp access-control member group info](info.md)
+- [itp access-control member group list](list.md)
diff --git a/docs/access-control/member/overview.md b/docs/access-control/member/overview.md
@@ -4,7 +4,7 @@ Manage members that can access an iTwin.
 
 ## Available Commands
 
-- [itp access-control member invitations](access-control/member/invitations.md)
-- [itp access-control member owner](access-control/member/owner/overview.md)
-- [itp access-control member group](access-control/member/group/overview.md)
-- [itp access-control member user](access-control/member/user/overview.md)
+- [itp access-control member invitations](invitations.md)
+- [itp access-control member owner](owner/overview.md)
+- [itp access-control member group](group/overview.md)
+- [itp access-control member user](user/overview.md)
diff --git a/docs/access-control/member/owner/overview.md b/docs/access-control/member/owner/overview.md
@@ -4,6 +4,6 @@ Manage access control for iTwin owners.
 
 ## Available Commands
 
-- [itp access-control member owner add](access-control/member/owner/add.md)
-- [itp access-control member owner delete](access-control/member/owner/delete.md)
-- [itp access-control member owner list](access-control/member/owner/list.md)
+- [itp access-control member owner add](add.md)
+- [itp access-control member owner delete](delete.md)
+- [itp access-control member owner list](list.md)
diff --git a/docs/access-control/member/user/overview.md b/docs/access-control/member/user/overview.md
@@ -4,8 +4,8 @@ Manage users that can access an iTwin.
 
 ## Available Commands
 
-- [itp access-control member user add](access-control/member/user/add.md)
-- [itp access-control member user update](access-control/member/user/update.md)
-- [itp access-control member user delete](access-control/member/user/delete.md)
-- [itp access-control member user info](access-control/member/user/info.md)
-- [itp access-control member user list](access-control/member/user/list.md)
+- [itp access-control member user add](add.md)
+- [itp access-control member user update](update.md)
+- [itp access-control member user delete](delete.md)
+- [itp access-control member user info](info.md)
+- [itp access-control member user list](list.md)
diff --git a/docs/access-control/overview.md b/docs/access-control/overview.md
@@ -4,7 +4,7 @@ Manage iTwin access control.
 
 ## Available Commands
 
-- [itp access-control permissions](access-control/permissions/overview.md)
-- [itp access-control role](access-control/role/overview.md)
-- [itp access-control group](access-control/group/overview.md)
-- [itp access-control member](access-control/member/overview.md)
+- [itp access-control permissions](permissions/overview.md)
+- [itp access-control role](role/overview.md)
+- [itp access-control group](group/overview.md)
+- [itp access-control member](member/overview.md)
diff --git a/docs/access-control/permissions/overview.md b/docs/access-control/permissions/overview.md
@@ -4,5 +4,5 @@ Get permission information.
 
 ## Available Commands
 
-- [itp access-control permissions me](access-control/permissions/me.md)
-- [itp access-control permissions all](access-control/permissions/all.md)
+- [itp access-control permissions me](me.md)
+- [itp access-control permissions all](all.md)
diff --git a/docs/access-control/role/overview.md b/docs/access-control/role/overview.md
@@ -4,8 +4,8 @@ Manage iTwin access control roles.
 
 ## Available Commands
 
-- [itp access-control role create](access-control/role/create.md)
-- [itp access-control role update](access-control/role/update.md)
-- [itp access-control role delete](access-control/role/delete.md)
-- [itp access-control role info](access-control/role/info.md)
-- [itp access-control role list](access-control/role/list.md)
+- [itp access-control role create](create.md)
+- [itp access-control role update](update.md)
+- [itp access-control role delete](delete.md)
+- [itp access-control role info](info.md)
+- [itp access-control role list](list.md)
diff --git a/docs/auth/overview.md b/docs/auth/overview.md
@@ -4,5 +4,6 @@ Authenticate itp with [Bentley](http://ims.bentley.com).
 
 ## Available Commands
 
-- [itp auth login](auth/login.md)
-- [itp auth logout](auth/logout.md)
+- [itp auth info](info.md)
+- [itp auth login](login.md)
+- [itp auth logout](logout.md)
diff --git a/docs/changed-elements/overview.md b/docs/changed-elements/overview.md
@@ -4,8 +4,8 @@ Compare two changesets of an iModel.
 
 ## Available Commands
 
-- [itp changed-elements enable](changed-elements/enable.md)
-- [itp changed-elements disable](changed-elements/disable.md)
-- [itp changed-elements info](changed-elements/info.md)
-- [itp changed-elements changesets](changed-elements/changesets.md)
-- [itp changed-elements comparison](changed-elements/comparison.md)
+- [itp changed-elements enable](enable.md)
+- [itp changed-elements disable](disable.md)
+- [itp changed-elements info](info.md)
+- [itp changed-elements changesets](changesets.md)
+- [itp changed-elements comparison](comparison.md)
diff --git a/docs/imodel/changeset/overview.md b/docs/imodel/changeset/overview.md
@@ -4,5 +4,5 @@ Work with changesets of an iModel.
 
 ## Available Commands
 
-- [itp imodel changeset info](imodel/changeset/info.md)
-- [itp imodel changeset list](imodel/changeset/list.md)
+- [itp imodel changeset info](info.md)
+- [itp imodel changeset list](list.md)
diff --git a/docs/imodel/connection/overview.md b/docs/imodel/connection/overview.md
@@ -4,11 +4,11 @@ Work with iModel connections.
 
 ## Available Commands
 
-- [itp imodel connection create](imodel/connection/create.md)
-- [itp imodel connection update](imodel/connection/update.md)
-- [itp imodel connection delete](imodel/connection/delete.md)
-- [itp imodel connection info](imodel/connection/info.md)
-- [itp imodel connection list](imodel/connection/list.md)
-- [itp imodel connection auth](imodel/connection/auth.md)
-- [itp imodel connection run](imodel/connection/run/overview.md)
-- [itp imodel connection sourcefile](imodel/connection/sourcefile/overview.md)
+- [itp imodel connection create](create.md)
+- [itp imodel connection update](update.md)
+- [itp imodel connection delete](delete.md)
+- [itp imodel connection info](info.md)
+- [itp imodel connection list](list.md)
+- [itp imodel connection auth](auth.md)
+- [itp imodel connection run](run/overview.md)
+- [itp imodel connection sourcefile](sourcefile/overview.md)
diff --git a/docs/imodel/connection/run/overview.md b/docs/imodel/connection/run/overview.md
@@ -4,6 +4,6 @@ Work with iModel connection runs.
 
 ## Available Commands
 
-- [itp imodel connection run create](imodel/connection/run/create.md)
-- [itp imodel connection run info](imodel/connection/run/info.md)
-- [itp imodel connection run list](imodel/connection/run/list.md)
+- [itp imodel connection run create](create.md)
+- [itp imodel connection run info](info.md)
+- [itp imodel connection run list](list.md)
diff --git a/docs/imodel/connection/sourcefile/overview.md b/docs/imodel/connection/sourcefile/overview.md
@@ -4,8 +4,8 @@ Work with iModel connection source files.
 
 ## Available Commands
 
-- [itp imodel connection sourcefile add](imodel/connection/sourcefile/add.md)
-- [itp imodel connection sourcefile update](imodel/connection/sourcefile/update.md)
-- [itp imodel connection sourcefile delete](imodel/connection/sourcefile/delete.md)
-- [itp imodel connection sourcefile info](imodel/connection/sourcefile/info.md)
-- [itp imodel connection sourcefile list](imodel/connection/sourcefile/list.md)
+- [itp imodel connection sourcefile add](add.md)
+- [itp imodel connection sourcefile update](update.md)
+- [itp imodel connection sourcefile delete](delete.md)
+- [itp imodel connection sourcefile info](info.md)
+- [itp imodel connection sourcefile list](list.md)
diff --git a/docs/imodel/named-version/overview.md b/docs/imodel/named-version/overview.md
@@ -4,6 +4,6 @@ Work with named versions of an iModel.
 
 ## Available Commands
 
-- [itp imodel named-version create](imodel/named-version/create.md)
-- [itp imodel named-version info](imodel/named-version/info.md)
-- [itp imodel named-version list](imodel/named-version/list.md)
+- [itp imodel named-version create](create.md)
+- [itp imodel named-version info](info.md)
+- [itp imodel named-version list](list.md)
diff --git a/docs/imodel/overview.md b/docs/imodel/overview.md
@@ -4,13 +4,13 @@ Work with iModels of an iTwin.
 
 ## Available Commands
 
-- [itp imodel create](imodel/create.md)
-- [itp imodel populate](imodel/populate.md)
-- [itp imodel update](imodel/update.md)
-- [itp imodel delete](imodel/delete.md)
-- [itp imodel info](imodel/info.md)
-- [itp imodel list](imodel/list.md)
-- [itp imodel view](imodel/view/overview.md)
-- [itp imodel changeset](imodel/changeset/overview.md)
-- [itp imodel namedversion](imodel/named-version/overview.md)
-- [itp imodel connection](imodel/connection/overview.md)
+- [itp imodel create](create.md)
+- [itp imodel populate](populate.md)
+- [itp imodel update](update.md)
+- [itp imodel delete](delete.md)
+- [itp imodel info](info.md)
+- [itp imodel list](list.md)
+- [itp imodel view](view/overview.md)
+- [itp imodel changeset](changeset/overview.md)
+- [itp imodel namedversion](named-version/overview.md)
+- [itp imodel connection](connection/overview.md)
diff --git a/docs/imodel/populate.md b/docs/imodel/populate.md
@@ -39,4 +39,4 @@ itp imodel populate --imodel-id i9j0k1l2-3456-78ab-cdef-9012345678ij --file mode
 
 ## Workflow Reference
 
-- [iModel Populate](/command-workflows/imodel-populate)
+- [iModel Populate](/docs/command-workflows/imodel-populate)
diff --git a/docs/imodel/view/cesium-sandcastle.md b/docs/imodel/view/cesium-sandcastle.md
@@ -33,4 +33,4 @@ itp imodel view cesium-sandcastle --imodel-id 5e19bee0-3aea-4355-a9f0-c6df9989ee
 
 ## Workflow Reference
 
-[Cesium Sandcastle](/command-workflows/cesium-sandcastle)
+[Cesium Sandcastle](/docs/command-workflows/cesium-sandcastle)
diff --git a/docs/imodel/view/overview.md b/docs/imodel/view/overview.md
@@ -4,4 +4,4 @@ View an iModel.
 
 ## Available Commands
 
-- [itp imodel view cesium-sandcastle](imodel/view/cesium-sandcastle.md)
+- [itp imodel view cesium-sandcastle](cesium-sandcastle.md)
diff --git a/docs/index.html b/docs/index.html
@@ -38,13 +38,15 @@
     window.$docsify = {
       loadSidebar: '_sidebar.md',
       alias: {
-        '/.*/_sidebar.md': '/_sidebar.md'
+        '/docs/(.*)': '/$1',
+        '/.*/_sidebar.md': '/_sidebar.md',
       },
       name: false,
       nameLink: '/',
       repo: '',
       autoHeader: true,
       onlyCover: false,
+      relativePath: true,
       routerMode: 'hash',
       copyCode: {
         buttonText: 'Copy',
diff --git a/docs/itwin/overview.md b/docs/itwin/overview.md
@@ -4,9 +4,9 @@ Work with iTwins.
 
 ## Available Commands
 
-- [itp itwin create](itwin/create.md)
-- [itp itwin update](itwin/update.md)
-- [itp itwin delete](itwin/delete.md)
-- [itp itwin info](itwin/info.md)
-- [itp itwin list](itwin/list.md)
-- [itp itwin repository](itwin/repository/overview.md)
+- [itp itwin create](create.md)
+- [itp itwin update](update.md)
+- [itp itwin delete](delete.md)
+- [itp itwin info](info.md)
+- [itp itwin list](list.md)
+- [itp itwin repository](repository/overview.md)
diff --git a/docs/itwin/repository/overview.md b/docs/itwin/repository/overview.md
@@ -4,6 +4,6 @@ Work with iTwin repositories.
 
 ## Available Commands
 
-- [itp itwin repository create](itwin/repository/create.md)
-- [itp itwin repository delete](itwin/repository/delete.md)
-- [itp itwin repository list](itwin/repository/list.md)
+- [itp itwin repository create](create.md)
+- [itp itwin repository delete](delete.md)
+- [itp itwin repository list](list.md)
diff --git a/docs/storage/file/overview.md b/docs/storage/file/overview.md
diff --git a/docs/storage/folder/overview.md b/docs/storage/folder/overview.md
diff --git a/docs/storage/overview.md b/docs/storage/overview.md
diff --git a/docs/user/overview.md b/docs/user/overview.md
diff --git a/docs/workflows/overview.md b/docs/workflows/overview.md
