Skip to content
Open
Show file tree
Hide file tree
Changes from all 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
10 changes: 9 additions & 1 deletion editor/publish.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
Your changes save automatically as you edit, but they only reach your live site when you publish them. What happens when you publish depends on which branch you work on and whether that branch requires pull requests.

<Note>
If you don't see a branch selector or a **Publish** button, your deployment has [auto publish](#auto-publish) turned on and your edits go live automatically.
If you don't see a **Publish** button, your deployment has [auto publish](#auto-publish) turned on and your edits go live automatically. If you don't see a branch selector, turn it on from the page options menu. See [Show the branch selector](#show-the-branch-selector).
</Note>

## Pending changes
Expand Down Expand Up @@ -47,6 +47,14 @@

Edit directly on your deployment branch if you do not use a Git-based workflow. Create a branch if each change goes through review before it reaches your live site.

### Show the branch selector

The branch selector appears in the editor toolbar when your deployment branch has branch protections or when you're already working on a feature branch. If you're on an unprotected deployment branch, the selector is hidden by default.

Check warning on line 52 in editor/publish.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/publish.mdx#L52

In general, use active voice instead of passive voice ('is hidden').

To show the branch selector, click <Icon icon="ellipsis" /> **More options** in the top-right of the page, then turn on **Branches**. This preference applies only to you.

### Create a branch

To create a branch, click the branch name in the editor toolbar, select **Create new branch**, enter a name, then click **Create branch**.

<Note>
Expand All @@ -67,6 +75,6 @@

## Auto publish

If your deployment has [auto publish](/editor/settings#main-branch-autocommits) turned on, the editor commits to your deployment branch shortly after you stop typing. The branch selector and **Publish** button are hidden. There is no pending state and no review step.

Check warning on line 78 in editor/publish.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/publish.mdx#L78

In general, use active voice instead of passive voice ('are hidden').

Edits on feature branches created from the editor commit automatically either way, but they never publish unless you merge them into your deployment branch.
2 changes: 1 addition & 1 deletion editor/tutorial.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ This tutorial walks you through a complete content update using the editor. You'

Working on a branch keeps your edits separate from your live site until you're ready to share the content with your users.

1. In the editor toolbar, click the branch name (usually `main`).
1. In the editor toolbar, click the branch name (usually `main`). If you don't see a branch name, click <Icon icon="ellipsis" /> **More options** in the top-right of the page, then turn on **Branches**.
<Frame>
<img src="/images/editor/create-branch-light.png" alt="Branch name emphasized in the editor toolbar." className="block dark:hidden" />
<img src="/images/editor/create-branch-dark.png" alt="Branch name emphasized in the editor toolbar." className="hidden dark:block" />
Expand Down
18 changes: 17 additions & 1 deletion es/editor/publish.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull re
Sus cambios se guardan automáticamente mientras edita, pero solo llegan a su sitio publicado cuando los publica. Lo que ocurre al publicar depende de en qué branch trabaja y de si esa branch requiere pull requests.

<Note>
Si no ve un selector de branch ni un botón **Publish**, su deployment tiene activada la [publicación automática](#auto-publish) y sus ediciones se publican automáticamente.
Si no ve un botón **Publish**, su deployment tiene activada la [publicación automática](#auto-publish) y sus ediciones se publican automáticamente. Si no ve un selector de branch, actívelo desde el menú de opciones de la página. Consulte [Mostrar el selector de branch](#show-the-branch-selector).
</Note>

<div id="pending-changes">
Expand Down Expand Up @@ -59,6 +59,22 @@ Solo puede realizarse una publicación a la vez por branch. Si un compañero pub

Edite directamente en su deployment branch si no usa un flujo de trabajo basado en Git. Cree una branch si cada cambio pasa por una revisión antes de llegar a su sitio publicado.

<div id="show-the-branch-selector">

### Mostrar el selector de branch

</div>

El selector de branch aparece en la barra de herramientas del editor cuando su deployment branch tiene protecciones de branch o cuando ya trabaja en una feature branch. Si está en una deployment branch sin protección, el selector está oculto de forma predeterminada.

Para mostrar el selector de branch, haga clic en <Icon icon="ellipsis" /> **More options** en la parte superior derecha de la página y active **Branches**. Esta preferencia solo se aplica a usted.

<div id="create-a-branch">

### Crear una branch

</div>

Para crear una branch, haga clic en el nombre de la branch en la barra de herramientas del editor, seleccione **Create new branch**, escriba un nombre y haga clic en **Create branch**.

<Note>
Expand Down
4 changes: 2 additions & 2 deletions es/editor/tutorial.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Cómo usar el editor"
description: "Recorrido paso a paso por el editor de Mintlify: cree una branch, edite páginas, comparta un despliegue de vista previa para su revisión y publique sus cambios."
description: "Recorrido paso a paso por el editor de Mintlify: cree una branch, edite páginas, comparta una vista previa para revisión y publique sus cambios."
keywords: ["editor", "tutorial", "branch", "publish"]
---

Expand All @@ -12,7 +12,7 @@ Este tutorial le guía a través de una actualización completa de contenido usa

Trabajar en una branch mantiene sus ediciones separadas de su sitio en producción hasta que esté listo para compartir el contenido con sus usuarios.

1. En la barra de herramientas del editor, haga clic en el nombre de la branch (normalmente `main`).
1. En la barra de herramientas del editor, haga clic en el nombre de la branch (normalmente `main`). Si no ve el nombre de la branch, haga clic en <Icon icon="ellipsis" /> **More options** en la parte superior derecha de la página y active **Branches**.
<Frame>
<img src="/images/editor/create-branch-light.png" alt="Nombre de la branch destacado en la barra de herramientas del editor." className="block dark:hidden" />
<img src="/images/editor/create-branch-dark.png" alt="Nombre de la branch destacado en la barra de herramientas del editor." className="hidden dark:block" />
Expand Down
16 changes: 14 additions & 2 deletions es/integrations/analytics/segment.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,28 @@ Agrega tu write key de Segment a tu archivo `docs.json` para enviar Analytics a
"integrations": {
"segment": {
"key": "required",
"cdnUrl": "optional"
}
}
```

```json Ejemplo
"integrations": {
"segment": {
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2"
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2",
"cdnUrl": "https://cdn.mydomain.com"
}
}
```

</CodeGroup>
</CodeGroup>

<div id="custom-cdn-url">

## URL de CDN personalizada

</div>

Si usas la [función de dominio personalizado de Segment](https://segment.com/docs/connections/sources/custom-domains/), configura `cdnUrl` para cargar el script de Segment desde tu dominio personalizado en lugar del predeterminado `cdn.segment.com`. Cargar desde tu propio dominio ayuda a evitar que los bloqueadores de anuncios bloqueen tus análisis.

El valor de `cdnUrl` debe ser una URL HTTPS sin parámetros de consulta ni fragmentos.
4 changes: 4 additions & 0 deletions es/organize/settings-integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -183,6 +183,10 @@ Configura todas las integraciones como propiedades del objeto `integrations` en
<ResponseField name="key" type="string" required>
Tu write key de Segment.
</ResponseField>

<ResponseField name="cdnUrl" type="string">
URL de CDN personalizada para cargar el script de Segment, para usar con la [función de dominio personalizado de Segment](https://segment.com/docs/connections/sources/custom-domains/). Debe ser una URL HTTPS sin parámetros de consulta ni fragmentos.
</ResponseField>
</Expandable>
</ResponseField>

Expand Down
20 changes: 18 additions & 2 deletions fr/editor/publish.mdx
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: "Publier des modifications"
sidebarTitle: "Publier"
description: "Publiez des modifications depuis l'éditeur vers votre site publié. Les branches et les règles de protection déterminent ce qui se passe lorsque vous publiez."
description: "Publiez des modifications depuis l'éditeur vers votre site. Les branches et les règles de protection déterminent ce qui se passe lorsque vous publiez."
keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull request"]
---

Vos modifications sont enregistrées automatiquement pendant que vous travaillez, mais elles n'atteignent votre site publié que lorsque vous les publiez. Ce qui se passe alors dépend de la branch sur laquelle vous travaillez et du fait que cette branch exige ou non des pull requests.

<Note>
Si vous ne voyez ni sélecteur de branch ni bouton **Publish**, la [publication automatique](#auto-publish) est activée sur votre deployment et vos modifications sont mises en ligne automatiquement.
Si vous ne voyez pas de bouton **Publish**, la [publication automatique](#auto-publish) est activée sur votre deployment et vos modifications sont mises en ligne automatiquement. Si vous ne voyez pas de sélecteur de branch, activez-le depuis le menu d'options de la page. Consultez [Afficher le sélecteur de branch](#show-the-branch-selector).
</Note>

<div id="pending-changes">
Expand Down Expand Up @@ -59,6 +59,22 @@ Une seule publication peut avoir lieu à la fois par branch. Si un collègue pub

Travaillez directement sur votre deployment branch si vous n'utilisez pas de workflow basé sur Git. Créez une branch si chaque modification passe par une révision avant d'atteindre votre site publié.

<div id="show-the-branch-selector">

### Afficher le sélecteur de branch

</div>

Le sélecteur de branch apparaît dans la barre d'outils de l'éditeur lorsque votre deployment branch a des protections de branch ou lorsque vous travaillez déjà sur une feature branch. Si vous êtes sur une deployment branch non protégée, le sélecteur est masqué par défaut.

Pour afficher le sélecteur de branch, cliquez sur <Icon icon="ellipsis" /> **More options** en haut à droite de la page, puis activez **Branches**. Cette préférence ne s'applique qu'à vous.

<div id="create-a-branch">

### Créer une branch

</div>

Pour créer une branch, cliquez sur le nom de la branch dans la barre d'outils de l'éditeur, sélectionnez **Create new branch**, saisissez un nom, puis cliquez sur **Create branch**.

<Note>
Expand Down
2 changes: 1 addition & 1 deletion fr/editor/tutorial.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Ce tutoriel vous guide à travers une mise à jour de contenu complète avec l'

Travailler sur une branche permet de garder vos modifications séparées de votre site en production jusqu'à ce que vous soyez prêt à partager le contenu avec vos utilisateurs.

1. Dans la barre d'outils de l'éditeur, cliquez sur le nom de la branche (généralement `main`).
1. Dans la barre d'outils de l'éditeur, cliquez sur le nom de la branche (généralement `main`). Si vous ne voyez pas le nom de la branche, cliquez sur <Icon icon="ellipsis" /> **More options** en haut à droite de la page, puis activez **Branches**.
<Frame>
<img src="/images/editor/create-branch-light.png" alt="Nom de la branche mis en évidence dans la barre d'outils de l'éditeur." className="block dark:hidden" />
<img src="/images/editor/create-branch-dark.png" alt="Nom de la branche mis en évidence dans la barre d'outils de l'éditeur." className="hidden dark:block" />
Expand Down
16 changes: 14 additions & 2 deletions fr/integrations/analytics/segment.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,28 @@ Ajoutez votre write key Segment à votre fichier `docs.json` pour envoyer des do
"integrations": {
"segment": {
"key": "required",
"cdnUrl": "optional"
}
}
```

```json Exemple
"integrations": {
"segment": {
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2"
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2",
"cdnUrl": "https://cdn.mydomain.com"
}
}
```

</CodeGroup>
</CodeGroup>

<div id="custom-cdn-url">

## URL de CDN personnalisée

</div>

Si vous utilisez la [fonctionnalité de domaine personnalisé de Segment](https://segment.com/docs/connections/sources/custom-domains/), définissez `cdnUrl` pour charger le script Segment depuis votre domaine personnalisé au lieu du domaine par défaut `cdn.segment.com`. Le chargement depuis votre propre domaine aide à empêcher les bloqueurs de publicités de bloquer vos analyses.

La valeur de `cdnUrl` doit être une URL HTTPS sans paramètres de requête ni fragments.
4 changes: 4 additions & 0 deletions fr/organize/settings-integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -183,6 +183,10 @@ Configurez toutes les intégrations comme propriétés de l'objet `integrations`
<ResponseField name="key" type="string" required>
Votre clé d'écriture Segment.
</ResponseField>

<ResponseField name="cdnUrl" type="string">
URL de CDN personnalisée pour charger le script Segment, à utiliser avec la [fonctionnalité de domaine personnalisé de Segment](https://segment.com/docs/connections/sources/custom-domains/). Doit être une URL HTTPS sans paramètres de requête ni fragments.
</ResponseField>
</Expandable>
</ResponseField>

Expand Down
12 changes: 10 additions & 2 deletions integrations/analytics/segment.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,24 @@ Add your Segment write key to your `docs.json` file to send analytics to Segment
"integrations": {
"segment": {
"key": "required",
"cdnUrl": "optional"
}
}
```

```json Example
"integrations": {
"segment": {
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2"
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2",
"cdnUrl": "https://cdn.mydomain.com"
}
}
```

</CodeGroup>
</CodeGroup>

## Custom CDN URL

If you use [Segment's custom domain feature](https://segment.com/docs/connections/sources/custom-domains/), set `cdnUrl` to load the Segment script from your custom domain instead of the default `cdn.segment.com`. Loading from your own domain helps prevent ad blockers from blocking your analytics.

The `cdnUrl` must be an HTTPS URL without query parameters or fragments.
4 changes: 4 additions & 0 deletions organize/settings-integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -183,6 +183,10 @@ Configure all integrations as properties of the `integrations` object in your `d
<ResponseField name="key" type="string" required>
Your Segment write key.
</ResponseField>

<ResponseField name="cdnUrl" type="string">
Custom CDN URL for loading the Segment script, for use with [Segment's custom domain feature](https://segment.com/docs/connections/sources/custom-domains/). Must be an HTTPS URL without query parameters or fragments.
</ResponseField>
</Expandable>
</ResponseField>

Expand Down
18 changes: 17 additions & 1 deletion zh/editor/publish.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull re
编辑时你的更改会自动保存,但只有在你发布之后才会出现在已发布的站点上。发布时会发生什么,取决于你在哪个分支上工作,以及该分支是否要求使用 pull request。

<Note>
如果你看不到分支选择器或 **Publish** 按钮,说明你的 deployment 已启用[自动发布](#auto-publish),你的更改会自动上线。
如果你看不到 **Publish** 按钮,说明你的 deployment 已启用[自动发布](#auto-publish),你的更改会自动上线。如果你看不到分支选择器,请在页面选项菜单中启用它。参见[显示分支选择器](#show-the-branch-selector)
</Note>

<div id="pending-changes">
Expand Down Expand Up @@ -59,6 +59,22 @@ keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull re

如果你不使用基于 Git 的工作流,可以直接在 deployment branch 上编辑。如果每项更改在上线前都需要审阅,请创建分支。

<div id="show-the-branch-selector">

### 显示分支选择器

</div>

当你的 deployment 分支设置了分支保护,或者你已经在 feature 分支上工作时,分支选择器会显示在编辑器工具栏中。如果你在未受保护的 deployment 分支上,分支选择器默认隐藏。

若要显示分支选择器,请点击页面右上角的 <Icon icon="ellipsis" /> **More options**,然后启用 **Branches**。此偏好设置仅对你自己生效。

<div id="create-a-branch">

### 创建分支

</div>

若要创建分支,请点击编辑器工具栏中的分支名称,选择 **Create new branch**,输入名称,然后点击 **Create branch**。

<Note>
Expand Down
2 changes: 1 addition & 1 deletion zh/editor/tutorial.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ keywords: ["编辑器", "教程", "分支", "发布"]

在分支上工作可以让你的编辑与线上站点保持隔离,直到你准备好与用户分享内容为止。

1. 在编辑器工具栏中,点击分支名称(通常为 `main`)。
1. 在编辑器工具栏中,点击分支名称(通常为 `main`)。如果看不到分支名称,请点击页面右上角的 <Icon icon="ellipsis" /> **More options**,然后启用 **Branches**。
<Frame>
<img src="/images/editor/create-branch-light.png" alt="编辑器工具栏中突出显示的分支名称。" className="block dark:hidden" />
<img src="/images/editor/create-branch-dark.png" alt="编辑器工具栏中突出显示的分支名称。" className="hidden dark:block" />
Expand Down
16 changes: 14 additions & 2 deletions zh/integrations/analytics/segment.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,28 @@ boost: 3
"integrations": {
"segment": {
"key": "required",
"cdnUrl": "optional"
}
}
```

```json 示例
"integrations": {
"segment": {
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2"
"key": "nqJxiRG15Y6M594P8Sb8ESEciU3VC2",
"cdnUrl": "https://cdn.mydomain.com"
}
}
```

</CodeGroup>
</CodeGroup>

<div id="custom-cdn-url">

## 自定义 CDN URL

</div>

如果你使用 [Segment 的自定义域名功能](https://segment.com/docs/connections/sources/custom-domains/),可以设置 `cdnUrl`,从你的自定义域名而不是默认的 `cdn.segment.com` 加载 Segment 脚本。从自己的域名加载有助于防止广告拦截器拦截你的分析数据。

`cdnUrl` 必须是 HTTPS URL,且不能包含查询参数或片段。
4 changes: 4 additions & 0 deletions zh/organize/settings-integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -183,6 +183,10 @@ boost: 3
<ResponseField name="key" type="string" required>
你的 Segment write key。
</ResponseField>

<ResponseField name="cdnUrl" type="string">
用于加载 Segment 脚本的自定义 CDN URL,配合 [Segment 的自定义域名功能](https://segment.com/docs/connections/sources/custom-domains/)使用。必须是 HTTPS URL,且不能包含查询参数或片段。
</ResponseField>
</Expandable>
</ResponseField>

Expand Down