Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(docusaurus): upgrade to v3 #3322

Merged
merged 16 commits into from
Jan 16, 2024
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .prettierignore
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
src/theme/DocItem
src/theme/DocPage
src/theme/DocRoot
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

DocPage has been replaced by DocRoot. The name is the only change that happened in Docusaurus v3.

legacy-stencil-components
scripts/bak

Expand Down
4 changes: 2 additions & 2 deletions docs/angular/build-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ See the [Standalone Migration Guide](#migrating-from-modules-to-standalone) for

### Usage with Standalone-based Applications

:::caution
:::warning
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution admonitions have been deprecated. It's recommended to use warning.

All Ionic imports should be imported from the `@ionic/angular/standalone` submodule. This includes imports such as components, directives, providers, and types. Importing from `@ionic/angular` may pull in lazy loaded Ionic code which can interfere with treeshaking.
:::

Expand Down Expand Up @@ -177,7 +177,7 @@ export class HomePage {}

### Usage with NgModule-based Applications

:::caution
:::warning
All Ionic imports should be imported from the `@ionic/angular/standalone` submodule. This includes imports such as components, directives, providers, and types. Importing from `@ionic/angular` may pull in lazy loaded Ionic code which can interfere with treeshaking.
:::

Expand Down
2 changes: 1 addition & 1 deletion docs/angular/navigation.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ Here, we have a typical Angular Module setup, along with a RouterModule import,

## Standalone Components

:::caution Experimental API
:::warning Experimental API

Standalone components is an experimental API introduced in Angular 14.x and available in Ionic 6.3 and later. This feature may change before it is stable.

Expand Down
2 changes: 1 addition & 1 deletion docs/angular/slides.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ import TabItem from '@theme/TabItem';
/>
</head>

:::caution Looking for `ion-slides`?
:::warning Looking for `ion-slides`?
`ion-slides` was deprecated in v6.0.0 and removed in v7.0.0. We recommend using the Swiper.js library directly. The migration process is detailed below.
:::

Expand Down
2 changes: 1 addition & 1 deletion docs/angular/virtual-scroll.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Virtual Scroll

:::caution Looking for `ion-virtual-scroll`?
:::warning Looking for `ion-virtual-scroll`?

`ion-virtual-scroll` was deprecated in v6.0.0 and removed in v7.0.0. We recommend using the `@angular/cdk` package detailed below.

Expand Down
2 changes: 1 addition & 1 deletion docs/deployment/play-store.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ keytool -genkey -v -keystore my-release-key.keystore -alias alias_name -keyalg R

Once that command has been ran and its prompts have been answered a file called `my-release-key.keystore` will be created in the current directory.

:::caution
:::warning
Save this file and keep it somewhere safe. If it is lost the Google Play Store will not accept updates for this app!
:::

Expand Down
16 changes: 4 additions & 12 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,18 +139,10 @@ Ionic is actively developed and maintained full-time by a core team, and its eco

There are millions of Ionic developers in over 200 countries worldwide. Here are some ways to join:

- <a href="https://forum.ionicframework.com/" target="_blank">
Forum:
</a> A great place for asking questions and sharing ideas.
- <a href="https://twitter.com/ionicframework" target="_blank">
Twitter:
</a> Where we post updates and share content from the Ionic community.
- <a href="https://github.com/ionic-team/ionic" target="_blank">
GitHub:
</a> For reporting bugs or requesting new features, create an issue here. PRs welcome!
- <a href="https://ionicframework.com/contributors" target="_blank">
Content authoring:
</a> Write a technical blog or share your story with the Ionic community.
- <a href="https://forum.ionicframework.com/" target="_blank">Forum:</a> A great place for asking questions and sharing ideas.
- <a href="https://twitter.com/ionicframework" target="_blank">Twitter:</a> Where we post updates and share content from the Ionic community.
- <a href="https://github.com/ionic-team/ionic" target="_blank">GitHub:</a> For reporting bugs or requesting new features, create an issue here. PRs welcome!
- <a href="https://ionicframework.com/contributors" target="_blank">Content authoring:</a> Write a technical blog or share your story with the Ionic community.

## License

Expand Down
2 changes: 1 addition & 1 deletion docs/react/slides.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ title: Migrating From IonSlides to Swiper.js
/>
</head>

:::caution Looking for `IonSlides`?
:::warning Looking for `IonSlides`?

`IonSlides` was deprecated in v6.0.0 and removed in v7.0.0. We recommend using the Swiper.js library directly. The migration process is detailed below.

Expand Down
2 changes: 1 addition & 1 deletion docs/react/virtual-scroll.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Virtual Scroll

:::caution Looking for `ion-virtual-scroll`?
:::warning Looking for `ion-virtual-scroll`?

`ion-virtual-scroll` was deprecated in v6.0.0 and removed in v7.0.0. We recommend using the Virtuoso package detailed below.

Expand Down
15 changes: 3 additions & 12 deletions docs/troubleshooting/native.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,7 @@ Running an app on an iOS device requires a provisioning profile. If a provisioni

For Cordova, open the `config.xml` file and modify the `id` attribute of the root element, `<widget>`. See [the Cordova documentation](https://cordova.apache.org/docs/en/latest/config_ref/#widget) for more information.

2. <strong>
Open the project in <b>Xcode</b>.
</strong>
2. <strong>Open the project in <b>Xcode</b>.</strong>

For Capacitor, run the following to open the app in Xcode:

Expand All @@ -36,18 +34,11 @@ Running an app on an iOS device requires a provisioning profile. If a provisioni

For Cordova, open Xcode. Use **File** &raquo; **Open** and locate the app. Open the app's `platforms/ios` directory.

3. <strong>
In <b>Project navigator</b>, select the project root to open the project editor. Under the **Identity** section,
verify that the Package ID that was set matches the Bundle Identifier.
</strong>
3. <strong>In <b>Project navigator</b>, select the project root to open the project editor. Under the **Identity** section, verify that the Package ID that was set matches the Bundle Identifier.</strong>

![Xcode Identity Setup](/img/running/ios-xcode-identity-setup.png)

4. <strong>
In the same project editor, under the <b>Signing</b> section, ensure <b>Automatically manage signing</b> is
enabled.
</strong> Then, select a Development Team. Given a Development Team, Xcode will attempt to automatically prepare provisioning
and signing.
4. <strong>In the same project editor, under the <b>Signing</b> section, ensure <b>Automatically manage signing</b> is enabled.</strong> Then, select a Development Team. Given a Development Team, Xcode will attempt to automatically prepare provisioning and signing.

![Xcode Signing Setup](/img/running/ios-xcode-signing-setup.png)

Expand Down
2 changes: 1 addition & 1 deletion docs/vue/slides.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ title: Migrating From ion-slides to Swiper.js
/>
</head>

:::caution Looking for `ion-slides`?
:::warning Looking for `ion-slides`?
`ion-slides` was deprecated in v6.0.0 and removed in v7.0.0. We recommend using the Swiper.js library directly. The migration process is detailed below.
:::

Expand Down
2 changes: 1 addition & 1 deletion docs/vue/virtual-scroll.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Virtual Scroll

:::caution Looking for `ion-virtual-scroll`?
:::warning Looking for `ion-virtual-scroll`?

`ion-virtual-scroll` was deprecated in v6.0.0 and removed in v7.0.0. We recommend using a Vue library to accomplish this. We outline one approach using `vue-virtual-scroller` below.

Expand Down
3 changes: 2 additions & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ module.exports = {
if (locale != 'en') {
return 'https://crowdin.com/project/ionic-docs';
}
let match;
if ((match = docPath.match(/api\/(.*)\.md/)) != null) {
return `https://github.com/ionic-team/ionic-docs/tree/main/docs/api/${match[1]}.md`;
}
Expand Down Expand Up @@ -275,7 +276,7 @@ module.exports = {
},
prism: {
theme: { plain: {}, styles: [] },
// https://github.com/FormidableLabs/prism-react-renderer/blob/5a1c93592c6475fb230bfcb8a9666b72b331638b/packages/generate-prism-languages/index.ts#L9-L24
// https://github.com/FormidableLabs/prism-react-renderer/blob/e6d323332b0363a633407fabab47b608088e3a4d/packages/generate-prism-languages/index.ts#L9-L25
additionalLanguages: ['shell-session', 'http'],
},
algolia: {
Expand Down
Loading
Loading