Restructure docs (#3180)

Co-authored-by: Lucas Nogueira <lucas@tauri.studio>
This commit is contained in:
Kasper
2022-01-07 13:30:23 +01:00
committed by GitHub
parent c7621aa019
commit 4f9c9e6307
50 changed files with 82 additions and 104 deletions

View File

@@ -84,7 +84,7 @@ This plugin allows you to very quickly install tauri in a vue-cli project.
## [tauri-vscode](https://github.com/tauri-apps/tauri-vscode)
This project enhances the VS Code interface with several nice-to-have features.
# Tauri Plugins [documentation](https://tauri.studio/en/docs/usage/guides/plugin)
# Tauri Plugins [documentation](https://tauri.studio/en/docs/guides/plugin)
Generally speaking, plugins are authored by third parties (even though there may be official, supported plugins). A plugin generally does 3 things:
1. It provides rust code to do "something".

View File

@@ -101,4 +101,4 @@ This command will show the current version of Tauri.
## CLI usage
See more about the usage through this [complete guide](/docs/usage/development/integration).
See more about the usage through this [complete guide](/docs/development/integration).

View File

@@ -188,4 +188,4 @@ This command will show the current version of Tauri.
## CLI usage
See more about the usage through this [complete guide](/docs/usage/development/integration).
See more about the usage through this [complete guide](/docs/development/integration).

View File

@@ -158,8 +158,8 @@ In addition to the JSON defined on the `tauri.conf.json` file, Tauri reads a pla
{ property: "longDescription", optional: true, type: "string", description: `A longer, multi-line description of the application.` },
{ property: "deb", optional: true, type: "object", child: <Properties anchorRoot="tauri.bundle.deb" rows={[
{ property: "depends", optional: true, type: "string[]", description: `The list of deb dependencies your application relies on.` },
{ property: "useBootstrapper", optional: true, type: "boolean", description: `Enable the <a href="/en/docs/usage/guides/bundler/debian#bootstrapper">boostrapper script</a>.` },
{ property: "files", optional: true, type: "{ [path: string]: string }", description: `The files to include on the package. See <a href="/en/docs/usage/guides/bundler/debian#custom-files">the debian guide</a>.` }]} />
{ property: "useBootstrapper", optional: true, type: "boolean", description: `Enable the <a href="/en/docs/guides/bundler/debian#bootstrapper">boostrapper script</a>.` },
{ property: "files", optional: true, type: "{ [path: string]: string }", description: `The files to include on the package. See <a href="/en/docs/guides/bundler/debian#custom-files">the debian guide</a>.` }]} />
},
{ property: "windows", optional: true, type: "object", child: <Properties anchorRoot="tauri.bundle.windows" rows={[
{ property: "digestAlgorithm", optional: true, type: "string", description: `Specifies the file digest algorithm to use for creating file signatures. Required for code signing. SHA-256 is recommended.` },

View File

@@ -1,6 +1,6 @@
---
id: workflow
title: Workflow
id: ci-cd
title: CI/CD
---
## Continuous Integration

View File

@@ -158,7 +158,7 @@ This information can be very helpful when triaging problems.
### Patterns
We've also defined prebuilt configurations called "Patterns". They may help you to customize Tauri to fit your needs.
[See more about patterns](/docs/usage/patterns/about-patterns).
[See more about patterns](/docs/guides/patterns/about-patterns).
## Vue CLI Plugin Tauri

View File

@@ -10,17 +10,10 @@ Here you will find guides and techniques to start a new project or add to your o
## Tauri Development Workflow
- [Integrate with Tauri](/docs/usage/development/integration)
- [Development Cycle](/docs/usage/development/development)
- [Debugging](/docs/usage/development/debugging)
- [App Publishing](/docs/usage/development/publishing)
- [Updating Packages](/docs/usage/development/updating)
## Guides
- [How to embed custom binaries](/docs/usage/guides/bundler/sidecar)
- [How to customize app icons](/docs/usage/guides/visual/icons)
## Others
- [Understanding Tauri Patterns](/docs/usage/patterns/about-patterns)
-
- [Integrate With Tauri](/docs/development/integration)
- [Development Cycle](/docs/development/development)
- [Debugging](/docs/development/debugging)
- [CI/CD](/docs/development/ci-cd)
- [Cross-Platform Compilation](/docs/development/cross-platform)
- [App Publishing](/docs/development/publishing)
- [Updating Packages](/docs/development/updating)

View File

@@ -44,4 +44,4 @@ Follow the platform-specific guides to get started:
windows: { title: 'Windows Setup', link: '/docs/getting-started/setup-windows'}
}} />
After that, you'll be ready to [add Tauri to your project!](/docs/usage/development/integration)
After that, you'll be ready to [add Tauri to your project!](/docs/development/integration)

View File

@@ -146,4 +146,4 @@ You can download some examples to try with `sudo apt-get install x11-apps`. xeye
## Continue
Now that you have set up the Linux-specific dependencies for Tauri, learn how to [add Tauri to your project](/docs/usage/development/integration).
Now that you have set up the Linux-specific dependencies for Tauri, learn how to [add Tauri to your project](/docs/development/integration).

View File

@@ -76,4 +76,4 @@ You may need to restart your terminal if the command does not work.
## Continue
Now that you have set up the macOS-specific dependencies for Tauri, learn how to [add Tauri to your project](/docs/usage/development/integration).
Now that you have set up the macOS-specific dependencies for Tauri, learn how to [add Tauri to your project](/docs/development/integration).

View File

@@ -72,4 +72,4 @@ If you have problems of any kind after following these instructions, we recommen
## Continue
Now that you have set up the Windows-specific dependencies for Tauri, learn how to [add Tauri to your project](/docs/usage/development/integration).
Now that you have set up the Windows-specific dependencies for Tauri, learn how to [add Tauri to your project](/docs/development/integration).

View File

@@ -59,7 +59,7 @@ See your local `strip` manpage for more information and flags that can be used t
### Allowlist config
You can also reduce the application size with the `allowlist` config, and only enabling what you need. Sometimes this is useful with Tauri's [Bridge-Pattern](/docs/usage/patterns/bridge) or others, depending on needs.
You can also reduce the application size with the `allowlist` config, and only enabling what you need. Sometimes this is useful with Tauri's [Bridge-Pattern](/docs/guides/patterns/bridge) or others, depending on needs.
For example in `tauri.conf.json` file:

View File

@@ -46,7 +46,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'
## Description
The Lockdown recipe is a minimal usage of the [Bridge pattern](/docs/usage/patterns/bridge), which only allows interaction between Rust and the Window via expiring JS Promise Closures that are injected into the Window by Rust and nulled as part of the callback.
The Lockdown recipe is a minimal usage of the [Bridge pattern](/docs/guides/patterns/bridge), which only allows interaction between Rust and the Window via expiring JS Promise Closures that are injected into the Window by Rust and nulled as part of the callback.
## Diagram

View File

@@ -1,101 +1,86 @@
[
{
"label": "Getting started",
"label": "Get started",
"type": "category",
"items": [
"getting-started/intro",
"getting-started/setup-linux",
"getting-started/setup-macos",
"getting-started/setup-windows"
"get-started/intro",
"get-started/setup-linux",
"get-started/setup-macos",
"get-started/setup-windows"
]
},
{
"label": "Usage",
"label": "Development",
"type": "category",
"items": [
"development/intro",
"development/integration",
"development/development",
"development/debugging",
"development/ci-cd",
"development/cross-platform",
"development/publishing",
"development/updating"
]
},
{
"label": "Guides",
"type": "category",
"items": [
"usage/intro",
{
"label": "Development",
"type": "category",
"items": [
"usage/development/integration",
"usage/development/development",
"usage/development/debugging",
"usage/development/publishing",
"usage/development/updating"
]
},
{
"label": "Patterns",
"type": "category",
"items": [
"usage/patterns/about-patterns",
"usage/patterns/hermit",
"usage/patterns/bridge",
"usage/patterns/cloudish",
"usage/patterns/cloudbridge",
"usage/patterns/lockdown",
"usage/patterns/multiwin",
"usage/patterns/glui"
"guides/patterns/about-patterns",
"guides/patterns/hermit",
"guides/patterns/bridge",
"guides/patterns/cloudish",
"guides/patterns/cloudbridge",
"guides/patterns/lockdown",
"guides/patterns/multiwin",
"guides/patterns/glui"
]
},
{
"label": "Guides",
"label": "Bundler",
"type": "category",
"items": [
"usage/guides/migration",
{
"label": "Bundler",
"type": "category",
"items": [
"usage/guides/bundler/introduction",
"usage/guides/bundler/anti-bloat",
"usage/guides/bundler/sidecar",
"usage/guides/bundler/debian",
"usage/guides/bundler/sign-osx"
]
},
"usage/guides/cli",
"usage/guides/command",
"usage/guides/events",
"usage/guides/plugin",
"usage/guides/updater",
{
"label": "Visual",
"type": "category",
"items": [
"usage/guides/visual/icons",
"usage/guides/visual/splashscreen",
"usage/guides/visual/window-customization",
"usage/guides/visual/menu",
"usage/guides/visual/system-tray"
]
},
{
"label": "WebDriver Testing",
"type": "category",
"items": [
"usage/guides/webdriver/introduction",
{
"label": "Example Application",
"type": "category",
"items": [
"usage/guides/webdriver/example/setup",
"usage/guides/webdriver/example/webdriverio",
"usage/guides/webdriver/example/selenium"
]
},
"usage/guides/webdriver/ci"
]
}
"guides/bundler/introduction",
"guides/bundler/anti-bloat",
"guides/bundler/sidecar",
"guides/bundler/debian",
"guides/bundler/sign-osx"
]
},
"guides/cli",
"guides/command",
"guides/events",
"guides/plugin",
"guides/updater",
"guides/icons",
"guides/splashscreen",
"guides/window-customization",
"guides/menu",
"guides/system-tray",
{
"label": "CI/CD",
"label": "WebDriver Testing",
"type": "category",
"items": ["usage/ci-cd/workflow", "usage/ci-cd/cross-platform"]
"items": [
"guides/webdriver/introduction",
{
"label": "Example Application",
"type": "category",
"items": [
"guides/webdriver/example/setup",
"guides/webdriver/example/webdriverio",
"guides/webdriver/example/selenium"
]
},
"guides/webdriver/ci"
]
},
"usage/contributor-guide"
"guides/migration",
"guides/contributor-guide"
]
},
{

View File

@@ -23,7 +23,7 @@ will be used that wraps around [wry]._
## Trying it out
Check out the documentation at https://tauri.studio/en/docs/usage/guides/webdriver/ci to build a small example
Check out the documentation at https://tauri.studio/en/docs/guides/webdriver/ci to build a small example
application that had WebDriver tests.
[WebDriver Intermediary Node]: https://www.w3.org/TR/webdriver/#dfn-intermediary-nodes