From 95c092a221075f40a170aa55bbf078f6e6cdb29c Mon Sep 17 00:00:00 2001 From: Deep Mehta Date: Mon, 16 Nov 2026 14:55:25 -0800 Subject: [PATCH 1/3] docs: add opt-in image sizes below the 750px cap Selected by filename suffix so pages keep plain markdown image syntax. Applies --sm to the Run on menu screenshot on the Cloud custom builds page. --- custom.css | 34 ++++++++++++++++++ development/deploy/cloud-custom-builds.mdx | 2 +- es/development/deploy/cloud-custom-builds.mdx | 2 +- .../deploy/{run-on.png => run-on--sm.png} | Bin ja/development/deploy/cloud-custom-builds.mdx | 2 +- ko/development/deploy/cloud-custom-builds.mdx | 2 +- zh/development/deploy/cloud-custom-builds.mdx | 2 +- 7 files changed, 39 insertions(+), 5 deletions(-) rename images/development/deploy/{run-on.png => run-on--sm.png} (100%) diff --git a/custom.css b/custom.css index 592642213d..311d76d5e7 100644 --- a/custom.css +++ b/custom.css @@ -382,3 +382,37 @@ body:has(.router-quickstart-marker) [data-component-part="card-content"] [data-c #content .frame:has(img) { max-width: calc(750px + 1rem); } + +/* + * Opt-in sizes below the 750px cap, selected by filename suffix so a page keeps + * plain markdown image syntax. Mintlify has no width attribute for + * `![alt](src)`, and the documented alternative is an HTML with a + * Tailwind class, which would mean converting every image that wants a + * different size. A suffix on the file name does the same job with a rename: + * + * ![Run on menu](/images/.../run-on--sm.png) + * + * Suffix is applied to the file, not the markdown, so alt text stays clean for + * screen readers and search. Click-to-zoom still opens the full-size image. + * + * Match with *= rather than $=: Mintlify serves images from its CDN with a + * query string appended (.../run-on--sm.png?fit=max&auto=format&...), so an + * ends-with selector would never match. The :not() repeats the cap rule's + * exclusion so these win on specificity rather than on source order. + */ +#content img[src*="--sm."]:not([data-component-part="card-image"]) { + max-width: min(100%, 400px); +} + +#content img[src*="--md."]:not([data-component-part="card-image"]) { + max-width: min(100%, 560px); +} + +/* Keep a Frame tight around a sized image rather than leaving it in a 750px box. */ +#content .frame:has(img[src*="--sm."]) { + max-width: calc(400px + 1rem); +} + +#content .frame:has(img[src*="--md."]) { + max-width: calc(560px + 1rem); +} diff --git a/development/deploy/cloud-custom-builds.mdx b/development/deploy/cloud-custom-builds.mdx index c1cf459b58..65c68961e6 100644 --- a/development/deploy/cloud-custom-builds.mdx +++ b/development/deploy/cloud-custom-builds.mdx @@ -34,7 +34,7 @@ If your Workflow uses Custom Nodes Comfy Cloud doesn't support, Comfy Cloud show ![Comfy Cloud dialog for a Workflow with Custom Nodes Comfy Cloud doesn't have, listing the missing Nodes above the Read the docs link, the Build with your agent button, and the Create on Platform button](/images/development/deploy/run-on-custom-deployment.png) - ![Run on menu open next to the Run button, with Comfy Cloud checked, the message This workspace has no deployments yet, and Create a custom deployment below it](/images/development/deploy/run-on.png) + ![Run on menu open next to the Run button, with Comfy Cloud checked, the message This workspace has no deployments yet, and Create a custom deployment below it](/images/development/deploy/run-on--sm.png) To create a Build without the dialog, click the cloud menu to the left of **Run**. By default, it's set to **Comfy Cloud**. diff --git a/es/development/deploy/cloud-custom-builds.mdx b/es/development/deploy/cloud-custom-builds.mdx index f0b003dd44..45f3ec7786 100644 --- a/es/development/deploy/cloud-custom-builds.mdx +++ b/es/development/deploy/cloud-custom-builds.mdx @@ -41,7 +41,7 @@ Si tu flujo de trabajo usa Nodos Personalizados que Comfy Cloud no admite, Comfy ![Diálogo de Comfy Cloud para un flujo de trabajo con Nodos Personalizados que Comfy Cloud no tiene, donde se enumeran los Nodos faltantes encima del enlace Leer la documentación, el botón Crea con tu agente y el botón Create on Platform](/images/development/deploy/run-on-custom-deployment.png) - ![Menú Run on abierto junto al botón Run, con Comfy Cloud marcado, el mensaje This workspace has no deployments yet y Create a custom deployment debajo](/images/development/deploy/run-on.png) + ![Menú Run on abierto junto al botón Run, con Comfy Cloud marcado, el mensaje This workspace has no deployments yet y Create a custom deployment debajo](/images/development/deploy/run-on--sm.png) Para crear una Build sin el diálogo, haz clic en el menú de la nube a la izquierda de **Run**. De forma predeterminada, está configurado en **Comfy Cloud**. diff --git a/images/development/deploy/run-on.png b/images/development/deploy/run-on--sm.png similarity index 100% rename from images/development/deploy/run-on.png rename to images/development/deploy/run-on--sm.png diff --git a/ja/development/deploy/cloud-custom-builds.mdx b/ja/development/deploy/cloud-custom-builds.mdx index dd0f516c5c..6843f27bd1 100644 --- a/ja/development/deploy/cloud-custom-builds.mdx +++ b/ja/development/deploy/cloud-custom-builds.mdx @@ -41,7 +41,7 @@ Build を作成する前に、以下を用意してください。 ![Comfy Cloudにないカスタムノードを使用するワークフローに対するComfy Cloudのダイアログ。ドキュメントを読むリンクの上に不足しているノードが一覧表示され、エージェントでビルドボタンとプラットフォームで作成ボタンがある](/images/development/deploy/run-on-custom-deployment.png) - ![実行ボタンの横で開いた実行メニュー。Comfy Cloudがチェックされており、「このワークスペースにはまだデプロイがありません」というメッセージと、その下にカスタムデプロイを作成が表示されている](/images/development/deploy/run-on.png) + ![実行ボタンの横で開いた実行メニュー。Comfy Cloudがチェックされており、「このワークスペースにはまだデプロイがありません」というメッセージと、その下にカスタムデプロイを作成が表示されている](/images/development/deploy/run-on--sm.png) ダイアログを使わずにビルドを作成するには、**実行**の左にあるクラウドメニューをクリックします。デフォルトでは**Comfy Cloud**に設定されています。 diff --git a/ko/development/deploy/cloud-custom-builds.mdx b/ko/development/deploy/cloud-custom-builds.mdx index 994abc6ca0..da188adc5b 100644 --- a/ko/development/deploy/cloud-custom-builds.mdx +++ b/ko/development/deploy/cloud-custom-builds.mdx @@ -41,7 +41,7 @@ translationBlockHashes: ![Comfy Cloud에 없는 커스텀 노드가 있는 워크플로에 대해 표시되는 Comfy Cloud 대화상자. 누락된 노드가 문서 읽기 링크 위에 나열되어 있고, 에이전트로 빌드 버튼과 플랫폼에서 생성 버튼이 있습니다](/images/development/deploy/run-on-custom-deployment.png) - ![실행 버튼 옆에 열린 실행 위치 메뉴. Comfy Cloud가 선택되어 있고, '이 워크스페이스에는 아직 배포가 없습니다'라는 메시지와 그 아래에 커스텀 배포 생성이 표시됩니다](/images/development/deploy/run-on.png) + ![실행 버튼 옆에 열린 실행 위치 메뉴. Comfy Cloud가 선택되어 있고, '이 워크스페이스에는 아직 배포가 없습니다'라는 메시지와 그 아래에 커스텀 배포 생성이 표시됩니다](/images/development/deploy/run-on--sm.png) 대화상자 없이 빌드를 만들려면 **실행** 왼쪽의 클라우드 메뉴를 클릭합니다. 기본적으로 **Comfy Cloud**로 설정되어 있습니다. diff --git a/zh/development/deploy/cloud-custom-builds.mdx b/zh/development/deploy/cloud-custom-builds.mdx index 2de266943e..9bf9b86529 100644 --- a/zh/development/deploy/cloud-custom-builds.mdx +++ b/zh/development/deploy/cloud-custom-builds.mdx @@ -41,7 +41,7 @@ translationBlockHashes: ![Comfy Cloud 针对包含其不支持的自定义节点的工作流所显示的对话框,在 Read the docs 链接上方列出缺失节点,并包含使用你的 agent 构建按钮和在平台上创建按钮](/images/development/deploy/run-on-custom-deployment.png) - ![运行按钮旁打开的运行菜单,其中已勾选 Comfy Cloud,显示消息“此工作区还没有任何部署”,下方是创建自定义部署](/images/development/deploy/run-on.png) + ![运行按钮旁打开的运行菜单,其中已勾选 Comfy Cloud,显示消息“此工作区还没有任何部署”,下方是创建自定义部署](/images/development/deploy/run-on--sm.png) 如需不通过对话框创建 Build,请点击 **运行** 左侧的云端菜单。默认情况下,它被设为 **Comfy Cloud**。 From b1dc60330ccbabd425665fbbf96891bc98690f37 Mon Sep 17 00:00:00 2001 From: Deep Mehta Date: Mon, 16 Nov 2026 15:11:31 -0800 Subject: [PATCH 2/3] docs: centre sized images and size the custom deployment dialog Adds --md to the Run on custom deployment dialog so the two stacked screenshots in that Step are no longer both full width, and centres sized images. Also matches on data-path, which carries the clean repo path, with src kept as a fallback. --- custom.css | 39 +++++++++++++----- development/deploy/cloud-custom-builds.mdx | 2 +- es/development/deploy/cloud-custom-builds.mdx | 2 +- ...t.png => run-on-custom-deployment--md.png} | Bin ja/development/deploy/cloud-custom-builds.mdx | 2 +- ko/development/deploy/cloud-custom-builds.mdx | 2 +- zh/development/deploy/cloud-custom-builds.mdx | 2 +- 7 files changed, 33 insertions(+), 16 deletions(-) rename images/development/deploy/{run-on-custom-deployment.png => run-on-custom-deployment--md.png} (100%) diff --git a/custom.css b/custom.css index 311d76d5e7..6d65072fae 100644 --- a/custom.css +++ b/custom.css @@ -384,35 +384,52 @@ body:has(.router-quickstart-marker) [data-component-part="card-content"] [data-c } /* - * Opt-in sizes below the 750px cap, selected by filename suffix so a page keeps - * plain markdown image syntax. Mintlify has no width attribute for - * `![alt](src)`, and the documented alternative is an HTML with a - * Tailwind class, which would mean converting every image that wants a - * different size. A suffix on the file name does the same job with a rename: + * Opt-in sizes below the 750px cap, selected by file name so a page keeps plain + * markdown image syntax. Mintlify has no width attribute for `![alt](src)` and + * the documented alternative is an HTML with a Tailwind class, which + * would mean converting every image that wants a different size. A suffix on + * the file does the same job with a rename: * - * ![Run on menu](/images/.../run-on--sm.png) + * ![Run on menu](/images/development/deploy/run-on--sm.png) * - * Suffix is applied to the file, not the markdown, so alt text stays clean for + * The suffix is on the file, not in the markdown, so alt text stays clean for * screen readers and search. Click-to-zoom still opens the full-size image. * - * Match with *= rather than $=: Mintlify serves images from its CDN with a - * query string appended (.../run-on--sm.png?fit=max&auto=format&...), so an - * ends-with selector would never match. The :not() repeats the cap rule's - * exclusion so these win on specificity rather than on source order. + * Matched on data-path, which Mintlify sets to the clean repo path, with src + * as a fallback. src carries a CDN query string + * (.../run-on--sm.png?fit=max&auto=format&...), so src has to be matched with + * *= rather than $=. The :not() repeats the cap rule's exclusion so these win + * on specificity rather than on source order. + * + * Sized images are centred. Every wrapper Mintlify puts between .prose and the + * image is display:contents, so the image has no box of its own to centre + * against; display:block plus margin-inline:auto on the image itself is what + * works. Scoped to sized images only, so an inline badge is never turned into + * a block. */ +#content img[data-path*="--sm."]:not([data-component-part="card-image"]), #content img[src*="--sm."]:not([data-component-part="card-image"]) { max-width: min(100%, 400px); + display: block; + margin-inline: auto; } +#content img[data-path*="--md."]:not([data-component-part="card-image"]), #content img[src*="--md."]:not([data-component-part="card-image"]) { max-width: min(100%, 560px); + display: block; + margin-inline: auto; } /* Keep a Frame tight around a sized image rather than leaving it in a 750px box. */ +#content .frame:has(img[data-path*="--sm."]), #content .frame:has(img[src*="--sm."]) { max-width: calc(400px + 1rem); + margin-inline: auto; } +#content .frame:has(img[data-path*="--md."]), #content .frame:has(img[src*="--md."]) { max-width: calc(560px + 1rem); + margin-inline: auto; } diff --git a/development/deploy/cloud-custom-builds.mdx b/development/deploy/cloud-custom-builds.mdx index 65c68961e6..9c849e2695 100644 --- a/development/deploy/cloud-custom-builds.mdx +++ b/development/deploy/cloud-custom-builds.mdx @@ -32,7 +32,7 @@ If your Workflow uses Custom Nodes Comfy Cloud doesn't support, Comfy Cloud show In the dialog, click **Create on Platform**. The Developer Platform opens in a new tab, on its **Deploy** page. - ![Comfy Cloud dialog for a Workflow with Custom Nodes Comfy Cloud doesn't have, listing the missing Nodes above the Read the docs link, the Build with your agent button, and the Create on Platform button](/images/development/deploy/run-on-custom-deployment.png) + ![Comfy Cloud dialog for a Workflow with Custom Nodes Comfy Cloud doesn't have, listing the missing Nodes above the Read the docs link, the Build with your agent button, and the Create on Platform button](/images/development/deploy/run-on-custom-deployment--md.png) ![Run on menu open next to the Run button, with Comfy Cloud checked, the message This workspace has no deployments yet, and Create a custom deployment below it](/images/development/deploy/run-on--sm.png) diff --git a/es/development/deploy/cloud-custom-builds.mdx b/es/development/deploy/cloud-custom-builds.mdx index 45f3ec7786..9f17a1e270 100644 --- a/es/development/deploy/cloud-custom-builds.mdx +++ b/es/development/deploy/cloud-custom-builds.mdx @@ -39,7 +39,7 @@ Si tu flujo de trabajo usa Nodos Personalizados que Comfy Cloud no admite, Comfy En el diálogo, haz clic en **Create on Platform**. La Developer Platform se abre en una pestaña nueva, en su página **Deploy**. - ![Diálogo de Comfy Cloud para un flujo de trabajo con Nodos Personalizados que Comfy Cloud no tiene, donde se enumeran los Nodos faltantes encima del enlace Leer la documentación, el botón Crea con tu agente y el botón Create on Platform](/images/development/deploy/run-on-custom-deployment.png) + ![Diálogo de Comfy Cloud para un flujo de trabajo con Nodos Personalizados que Comfy Cloud no tiene, donde se enumeran los Nodos faltantes encima del enlace Leer la documentación, el botón Crea con tu agente y el botón Create on Platform](/images/development/deploy/run-on-custom-deployment--md.png) ![Menú Run on abierto junto al botón Run, con Comfy Cloud marcado, el mensaje This workspace has no deployments yet y Create a custom deployment debajo](/images/development/deploy/run-on--sm.png) diff --git a/images/development/deploy/run-on-custom-deployment.png b/images/development/deploy/run-on-custom-deployment--md.png similarity index 100% rename from images/development/deploy/run-on-custom-deployment.png rename to images/development/deploy/run-on-custom-deployment--md.png diff --git a/ja/development/deploy/cloud-custom-builds.mdx b/ja/development/deploy/cloud-custom-builds.mdx index 6843f27bd1..de80e2be4e 100644 --- a/ja/development/deploy/cloud-custom-builds.mdx +++ b/ja/development/deploy/cloud-custom-builds.mdx @@ -39,7 +39,7 @@ Build を作成する前に、以下を用意してください。 ダイアログで**プラットフォームで作成**をクリックします。Developer Platformが新しいタブで開き、**デプロイ**ページが表示されます。 - ![Comfy Cloudにないカスタムノードを使用するワークフローに対するComfy Cloudのダイアログ。ドキュメントを読むリンクの上に不足しているノードが一覧表示され、エージェントでビルドボタンとプラットフォームで作成ボタンがある](/images/development/deploy/run-on-custom-deployment.png) + ![Comfy Cloudにないカスタムノードを使用するワークフローに対するComfy Cloudのダイアログ。ドキュメントを読むリンクの上に不足しているノードが一覧表示され、エージェントでビルドボタンとプラットフォームで作成ボタンがある](/images/development/deploy/run-on-custom-deployment--md.png) ![実行ボタンの横で開いた実行メニュー。Comfy Cloudがチェックされており、「このワークスペースにはまだデプロイがありません」というメッセージと、その下にカスタムデプロイを作成が表示されている](/images/development/deploy/run-on--sm.png) diff --git a/ko/development/deploy/cloud-custom-builds.mdx b/ko/development/deploy/cloud-custom-builds.mdx index da188adc5b..c6bc2d7bde 100644 --- a/ko/development/deploy/cloud-custom-builds.mdx +++ b/ko/development/deploy/cloud-custom-builds.mdx @@ -39,7 +39,7 @@ translationBlockHashes: 대화상자에서 **플랫폼에서 생성**을 클릭합니다. 새 탭에서 개발자 플랫폼의 **배포** 페이지가 열립니다. - ![Comfy Cloud에 없는 커스텀 노드가 있는 워크플로에 대해 표시되는 Comfy Cloud 대화상자. 누락된 노드가 문서 읽기 링크 위에 나열되어 있고, 에이전트로 빌드 버튼과 플랫폼에서 생성 버튼이 있습니다](/images/development/deploy/run-on-custom-deployment.png) + ![Comfy Cloud에 없는 커스텀 노드가 있는 워크플로에 대해 표시되는 Comfy Cloud 대화상자. 누락된 노드가 문서 읽기 링크 위에 나열되어 있고, 에이전트로 빌드 버튼과 플랫폼에서 생성 버튼이 있습니다](/images/development/deploy/run-on-custom-deployment--md.png) ![실행 버튼 옆에 열린 실행 위치 메뉴. Comfy Cloud가 선택되어 있고, '이 워크스페이스에는 아직 배포가 없습니다'라는 메시지와 그 아래에 커스텀 배포 생성이 표시됩니다](/images/development/deploy/run-on--sm.png) diff --git a/zh/development/deploy/cloud-custom-builds.mdx b/zh/development/deploy/cloud-custom-builds.mdx index 9bf9b86529..f0b5e9deb8 100644 --- a/zh/development/deploy/cloud-custom-builds.mdx +++ b/zh/development/deploy/cloud-custom-builds.mdx @@ -39,7 +39,7 @@ translationBlockHashes: 在对话框中,点击 **在平台上创建**。开发者平台会在新标签页中打开,并停留在 **部署** 页面。 - ![Comfy Cloud 针对包含其不支持的自定义节点的工作流所显示的对话框,在 Read the docs 链接上方列出缺失节点,并包含使用你的 agent 构建按钮和在平台上创建按钮](/images/development/deploy/run-on-custom-deployment.png) + ![Comfy Cloud 针对包含其不支持的自定义节点的工作流所显示的对话框,在 Read the docs 链接上方列出缺失节点,并包含使用你的 agent 构建按钮和在平台上创建按钮](/images/development/deploy/run-on-custom-deployment--md.png) ![运行按钮旁打开的运行菜单,其中已勾选 Comfy Cloud,显示消息“此工作区还没有任何部署”,下方是创建自定义部署](/images/development/deploy/run-on--sm.png) From c4c39f0e4fcdcf1a64f61fb4ed583d917de60d89 Mon Sep 17 00:00:00 2001 From: Deep Mehta Date: Mon, 16 Nov 2026 16:07:21 -0800 Subject: [PATCH 3/3] docs: correct the comment on how sized images are centred --- custom.css | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/custom.css b/custom.css index 6d65072fae..732975ca4e 100644 --- a/custom.css +++ b/custom.css @@ -401,11 +401,15 @@ body:has(.router-quickstart-marker) [data-component-part="card-content"] [data-c * *= rather than $=. The :not() repeats the cap rule's exclusion so these win * on specificity rather than on source order. * - * Sized images are centred. Every wrapper Mintlify puts between .prose and the - * image is display:contents, so the image has no box of its own to centre - * against; display:block plus margin-inline:auto on the image itself is what - * works. Scoped to sized images only, so an inline badge is never turned into - * a block. + * Sized images are centred by max-width plus margin-inline:auto, which only + * work as a pair: the max-width is what leaves spare room in the container for + * auto margins to split, so margin-inline on an unsized image does nothing. + * Centring has to go on the image itself rather than a wrapper, because every + * wrapper Mintlify puts between .prose and the image is display:contents and + * generates no box to centre against. display:block is belt and braces, since + * auto margins are ignored on an inline box and Tailwind preflight already + * sets img{display:block}; it is kept so the rule does not depend on preflight + * staying that way. */ #content img[data-path*="--sm."]:not([data-component-part="card-image"]), #content img[src*="--sm."]:not([data-component-part="card-image"]) {