diff --git a/content/pages/comparisons/index.html b/content/pages/comparisons/index.html new file mode 100644 index 00000000..6974f878 --- /dev/null +++ b/content/pages/comparisons/index.html @@ -0,0 +1,96 @@ +{# View this page at http://localhost:8080/comparisons/ #} + + + + Read the Docs vs Other Documentation Platforms + + + + + + + + {% import "partials/basic.html" as basic %} + +
+ {% call basic.header_lead( + header="Compare Read the Docs with other platforms") + %} +

+ While there are many options for hosting documentation, + Read the Docs is purpose-built for technical documentation with features that make both documentation authors and readers more productive. +

+

+ Compare Read the Docs with other popular documentation platforms to find the best solution for your needs. +

+ {% endcall %} +
+ +
+
+
+ + {{ basic.comparison_card( + url="/comparisons/github-pages/", + logo_url="/images/github-logo.svg", + logo_alt="GitHub Pages logo", + title="GitHub Pages", + meta="Static site hosting", + description="GitHub Pages is primarily for static hosting, but lacks documentation-specific features. See how Read the Docs compares." + ) }} + + {{ basic.comparison_card( + url="/comparisons/gitbook/", + logo_url="/images/gitbook-logo.svg", + logo_alt="GitBook logo", + title="GitBook", + meta="Documentation platform", + description="GitBook offers documentation hosting but with limited flexibility. Learn how Read the Docs gives you more control." + ) }} + + {{ basic.comparison_card( + url="/comparisons/cloudflare-pages/", + logo_url="/images/cloudflare-pages-logo.svg", + logo_alt="Cloudflare Pages logo", + title="Cloudflare Pages", + meta="Web hosting platform", + description="Cloudflare Pages is built for SPA hosting and not documentation. See why Read the Docs is better suited for your docs." + ) }} + +
+
+
+ +
+
+
+
+
+
+

+ Ready to get started? +

+ +

+ Read the Docs is the all-in-one solution that provides everything you need + for hosting documentation, from authentication to versioning. + Try it today and see the difference! +

+ +

+ + + Get started for free + +

+
+
+
+
+
+
+ + + diff --git a/content/partials/basic.html b/content/partials/basic.html index a8eb0bb0..ece20638 100644 --- a/content/partials/basic.html +++ b/content/partials/basic.html @@ -107,3 +107,38 @@

{% endmacro %} + +{# + Comparison card with logo and description + + Used for platform comparison pages to show different services that can be compared. + + :param url: URL to the comparison page + :param logo_url: URL to the platform logo + :param logo_alt: Alt text for the logo + :param title: Card title/platform name + :param meta: Short description below title + :param description: Main card description +#} +{% macro comparison_card(url, logo_url, logo_alt, title, meta, description) %} + +
+
+
+ {{ logo_alt }} +
+
+
+ {{ title }} +
+
{{ meta }}
+
+ {{ description }} +
+
+
+ + Compare with {{ title }} +
+ +{% endmacro %} diff --git a/readthedocs_theme/templates/includes/footer.html b/readthedocs_theme/templates/includes/footer.html index d10dc2de..c148affe 100644 --- a/readthedocs_theme/templates/includes/footer.html +++ b/readthedocs_theme/templates/includes/footer.html @@ -27,9 +27,7 @@

Learn more

Documentation Getting started guide Configure your project - Comparison to GitHub Pages - Comparison to GitBook - Comparison to Cloudflare Pages + Compare to other platforms {% endblock menu_learn %}