Merge remote-tracking branch 'origin/fix/alternate-absolute' into fix/alternate-absolute

Author: HonzaTuron

apify-api/openapi/paths/actor-runs/actor-runs@{runId}@charge.yaml

@@ -7,6 +7,12 @@ post:
     The event you are charging for must be one of the configured events in your Actor. If the Actor is not set up as pay per event, or if the event is not configured,
     the endpoint will return an error. The endpoint must be called from the Actor run itself, with the same API token that the run was started with.
 
+    :::info Learn more about pay-per-event pricing
+
+    For more details about pay-per-event (PPE) pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
+
+    :::
+
   operationId: PostChargeRun
   parameters:
     - name: runId

apify-api/openapi/paths/datasets/datasets@{datasetId}.yaml

@@ -5,6 +5,9 @@ get:
   description: |
     Returns dataset object for given dataset ID.
 
+    This does not return dataset items, only information about the storage itself.
+    To retrieve dataset items, use the [List dataset items](/api/v2/dataset-items-get) endpoint.
+
     :::note
 
     Keep in mind that attributes `itemCount` and `cleanItemCount` are not propagated right away after data are pushed into a dataset.

apify-api/plugins/decorators/client-references-links-decorator.js

@@ -34,8 +34,8 @@ function ClientReferencesLinksDecorator(target) {
     const pyLink = target[X_PY_DOC_URLS_PROPERTY];
     const jsLink = target[X_JS_DOC_URLS_PROPERTY];
 
-    const jsImgUrl = 'https://raw.githubusercontent.com/apify/openapi/b1206ac2adf8f39b05e5a09bf32c2802af58d851/assets/javascript.svg';
-    const pyImgUrl = 'https://raw.githubusercontent.com/apify/openapi/b1206ac2adf8f39b05e5a09bf32c2802af58d851/assets/python.svg';
+    const jsImgUrl = '/img/javascript-40x40.svg';
+    const pyImgUrl = '/img/python-40x40.svg';
 
     const jsAlt = 'Apify API JavaScript Client Reference';
     const pyAlt = 'Apify API Python Client Reference';
@@ -49,11 +49,13 @@ function ClientReferencesLinksDecorator(target) {
     }
 
     if (pyLink) {
-        prepend += `<a href="${pyLink}" target="_blank"><img src="${pyImgUrl}" class="openapi-clients-box-icon" alt="${pyAlt}"/></a>`;
+        prepend += `<a href="${pyLink}" target="_blank" class="client-docs-link">
+            <img src="${pyImgUrl}" class="openapi-clients-box-icon" width="24px" height="24px" alt="${pyAlt}"/>Python</a>`;
     }
 
     if (jsLink) {
-        prepend += `<a href="${jsLink}" target="_blank"><img src="${jsImgUrl}" class="openapi-clients-box-icon" alt="${jsAlt}" /></a>`;
+        prepend += `<a href="${jsLink}" target="_blank" class="client-docs-link">
+            <img src="${jsImgUrl}" class="openapi-clients-box-icon" width="24px" height="24px" alt="${jsAlt}" />JavaScript</a>`;
     }
 
     prepend += `</span>`;

apify-docs-theme/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@apify/docs-theme",
-    "version": "1.0.210",
+    "version": "1.0.213",
     "description": "",
     "main": "./src/index.js",
     "files": [

apify-docs-theme/src/theme/DocItemContent/index.js

@@ -7,6 +7,8 @@ import MDXContent from '@theme/MDXContent';
 import clsx from 'clsx';
 import React from 'react';
 
+import styles from './styles.module.css';
+
 function useSyntheticTitle() {
   const { metadata, frontMatter, contentTitle } = useDoc();
   const shouldRender = !frontMatter.hide_title && typeof contentTitle === 'undefined';
@@ -62,11 +64,15 @@ export default function DocItemContent({ children }) {
   const shouldShowLLMButtons = allowedPaths.some((path) => location.pathname.startsWith(path))
     && !disallowedPaths.some((path) => location.pathname.includes(path));
 
-  return (
-    <div className={clsx(ThemeClassNames.docs.docMarkdown, 'markdown')}>
-      {syntheticTitle && <Heading as="h1">{syntheticTitle}</Heading>}
-      {shouldShowLLMButtons && <LLMButtons />}
-      <MDXContent>{children}</MDXContent>
-    </div>
-  );
+    return (
+        <div className={clsx(ThemeClassNames.docs.docMarkdown, 'markdown')}>
+            {(syntheticTitle || shouldShowLLMButtons) && (
+                <div className={styles.docItemContent}>
+                    {syntheticTitle && <Heading as="h1">{syntheticTitle}</Heading>}
+                    {shouldShowLLMButtons && <LLMButtons />}
+                </div>
+            )}
+            <MDXContent>{children}</MDXContent>
+        </div>
+    );
 }

apify-docs-theme/src/theme/DocItemContent/styles.module.css

@@ -0,0 +1,17 @@
+.docItemContent {
+    display: flex;
+    align-items: center;
+    flex-wrap: wrap;
+    /* move the h1 margin to padding */
+    h1 {
+        margin-bottom: 0 !important;
+    }
+    padding-bottom: calc(
+        var(--ifm-h1-vertical-rhythm-bottom) * var(--ifm-leading)
+    );
+
+    @media (max-width: 767px) {
+        flex-direction: column;
+        align-items: flex-start;
+    }
+}