diff --git a/content/includes/try-it-out-custom.html b/content/includes/try-it-out-custom.html new file mode 100644 index 00000000..b902faa2 --- /dev/null +++ b/content/includes/try-it-out-custom.html @@ -0,0 +1,108 @@ +
+
Try it out
+
+ +
+
+

+ Upgrade your documentation with Read the Docs +

+ +
+ +
+
+ + {# Stylized code blocks #} + {% call technical.code_block(title=".readthedocs.yaml", icon="fa-file") %} + {% markdown %} + + ```yaml + # Read the Docs configuration file for Sphinx projects + # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + + # Required + version: 2 + + # Set the OS, Python version and other tools you might need + build: + os: ubuntu-24.04 + tools: + python: "3.12" + nodejs: "20" + # You can also specify other tool versions: + # rust: "1.70" + # golang: "1.20" + + # Support any tool with custom build commands + commands: + # Install dependencies + - cd docs/ && npm install + # Build the site + - cd docs/ && npm run build + # Copy generated files into Read the Docs directory + - mkdir --parents $READTHEDOCS_OUTPUT/html/ + - cp --recursive docs/build/* $READTHEDOCS_OUTPUT/html/ + + ``` + {% endmarkdown %} + {% endcall %} +
+
+ +
+
+
+ + {%- set header_1 = "Create an account" %} + {%- set icon_1 = "fa-square-1" -%} + + + + {{ header_1 }} + + + Sign up + + with GitHub or your email. + + + + + {%- set header_2 = "Import your project" %} + {%- set icon_2 = "fa-square-2" -%} + + + + {{ header_2 }} + Select your existing Git repositories with a 1-click interface. + + + + {%- set header_3 = "Add YAML config" %} + {%- set icon_3 = "fa-square-3" -%} + + + + {{ header_3 }} + Start with this example, and then adapt it. + + + + {%- set header_4 = "Your docs build on every commit" %} + {%- set icon_4 = "fa-square-4" -%} + + + + {{ header_4 }} + Like magic. + + +
+
+
+ +
+
+
diff --git a/content/pages/custom.html b/content/pages/custom.html new file mode 100644 index 00000000..f1829f73 --- /dev/null +++ b/content/pages/custom.html @@ -0,0 +1,124 @@ +{# + The goal of this page is to highlight the flexibility of our platform in supporting any documentation tool, + with full customization of the build commands you can run. +#} + +{# + View this page at http://localhost:8080/tools/custom/ +#} + + + + Host any documentation tool + + + + + + + +{% import "partials/basic.html" as basic %} +{% import "partials/marketing.html" as marketing %} +{% import "partials/technical.html" as technical %} +{% import "partials/homepage.html" as homepage %} + +
+ {% call basic.header_image( + header="Deploy with any tool", + image="/images/homepage.png", + image_alt="Examples of Read the Docs hosted documentation", + vertical_align="middle") + %} +

+ Read the Docs supports any documentation tool by allowing full control of the build commands your project runs. + Enjoy powerful features such as search-as-you-type, previews from Git, and much more. +

+ +

+ + + Create an account + + + Learn more + +

+ {% endcall %} +
+ +
+ {% call marketing.highlight_list() %} + + {% call marketing.highlight_item( + icon="olive fa-people-arrows", + icon_style="--fa-secondary-color: violet; --fa-secondary-opacity: 1;", + header="Collaborate with deploy previews", + color="violet") %} + {% markdown %} + Receive feedback from your team, + and have confidence in changes before they go live. + {% endmarkdown %} + {% endcall %} + + {% call marketing.highlight_item( + icon="yellow fa-magnifying-glass", + icon_style="--fa-secondary-color: white; --fa-secondary-opacity: 1;", + header="Always find what you need", + color="violet") %} + {% markdown %} + Search across all your projects with our search-as-you-type interface, + and never lose documentation again. + {% endmarkdown %} + {% endcall %} + + {% call marketing.highlight_item( + icon="fa-cogs", + header="Full customization of build commands", + color="violet") %} + {% markdown %} + Customize the build commands to suit your project's needs. + Flexibility to support any tool. + {% endmarkdown %} + {% endcall %} + + {% endcall %} +
+ +{# Try it out code block #} +{% include "includes/try-it-out-custom.html" %} + +{% block homepage_bottom_callout %} +
+
+
+ +
+
+ +
+

+ Get started with any documentation tool today. +

+ +

+ + + Create an account + +

+
+ +
+
+ +
+
+
+{% endblock homepage_bottom_callout %} + + + diff --git a/readthedocs_theme/templates/includes/topnav.html b/readthedocs_theme/templates/includes/topnav.html index 6c405912..b9d9bcb8 100644 --- a/readthedocs_theme/templates/includes/topnav.html +++ b/readthedocs_theme/templates/includes/topnav.html @@ -46,6 +46,7 @@ Sphinx Mkdocs Jupyter Book + Other tools {% endif %}