Add brand colors and fix title display

Now, primary color is the Pulp blue.

Also, the "Pulp Project" on the header of the site was broken as a
side-effect of hiding h1 titles on section pages with "display: none".

Closes #22

Author: pedro-psb

src/pulp_docs/data/mkdocs.yml

@@ -6,7 +6,7 @@ repo_name: pulp/pulpcore
 docs_dir: docs
 theme:
   name: material
-  logo: pulp-docs/docs/assets/logo.png
+  logo: pulp-docs/docs/assets/pulp_logo_icon.svg
   favicon: pulp-docs/docs/assets/favicon.ico
   features:
     - content.code.annotate
@@ -25,7 +25,7 @@ theme:
   palette:
     - media: "(prefers-color-scheme: light)"
       scheme: default
-      primary: indigo
+      primary: custom
       accent: black
       toggle:
         icon: material/toggle-switch-off-outline 

src/pulp_docs/mkdocs_macros.py

@@ -111,7 +111,7 @@ def prepare_repositories(TMPDIR: Path, repos: Repos, config: Config):
 
     # Copy core-files (shipped with pulp-docs) to tmpdir
     shutil.copy(
-        repo_sources / repos.core_repo.name / SRC_DOCS_DIRNAME / "index.md",
+        repo_sources / "pulp-docs" / SRC_DOCS_DIRNAME / "index.md",
         repo_docs / "index.md",
     )
 

staging_docs/assets/pulp_logo_icon.svg

@@ -29,7 +29,13 @@
     text-align: center;
     margin-inline: auto;
 }
+.hide-h1 {
+    position: absolute;
+    left: -999px
+}
 
-.landing-page-h1 {
-    display: None;
+:root {
+  --md-primary-fg-color:        #347dbe;
+  --md-primary-fg-color--light: #ECB7B7;
+  --md-primary-fg-color--dark:  #90030C;/
 }

staging_docs/css/extra.css

@@ -0,0 +1,53 @@
+---
+hide:
+  - navigation
+  - toc
+  - footer
+---
+
+# Home {.hide-h1}
+<div class="hero-header" markdown>
+
+![Pulp Logo](site:pulpcore/docs/assets/pulp_logo_big.png)
+
+## Pulp is an open source project that makes it easy for developers to fetch, upload, and distribute *Software Packages* on-prem or in the cloud. {: #pulp-project}
+
+</div>
+
+---
+
+<div class="grid cards" markdown>
+
+-   :material-clock-fast:{ .lg .middle } **Starter Tutorial**
+
+    ---
+
+    Learn to manage content with Pulp and get yourself familiar with core concepts and workflows.
+
+    [:octicons-arrow-right-24: Getting started](site:pulpcore/docs/user/tutorials/01-overview/)
+
+-   :octicons-download-16:{ .lg .middle } **Pulp in a Container**
+
+    ---
+
+    Use OCI (Open Container Initiative) images to install Pulp in single or multi-container setups.
+
+    [:octicons-arrow-right-24: Installation Quickstart](site:pulp-oci-images/docs/admin/tutorials/quickstart/)
+
+-   :octicons-rocket-16:{ .lg .middle } **Why Pulp?**
+
+    ---
+
+    Learn why important projects rely on Pulp to manage the lifecyle of huge *Software Content* collections.
+
+    [:octicons-arrow-right-24: Features](#)
+
+-   :octicons-people-16:{ .lg .middle } **Get Involved**
+
+    ---
+
+    Join our communication channels and get to know the contributors and users of Pulp's strong ecosystem.
+
+    [:octicons-arrow-right-24: Community](#)
+
+</div>

staging_docs/index.md

@@ -2,8 +2,10 @@
 hide:
   - toc
 ---
+
+# Admin Guide {.hide-h1}
+
 <div class="hero-header" markdown>
-<h1 class="landing-page-h1"></h1>
 
 ## This section is for **admins**
 

staging_docs/sections/admin/index.md

@@ -2,8 +2,10 @@
 hide:
   - toc
 ---
+
+# Developer Guide {.hide-h1}
+
 <div class="hero-header" markdown>
-<h1 class="landing-page-h1"></h1>
 
 ## This section is for Pulp **developers**
 

staging_docs/sections/dev/index.md

@@ -2,9 +2,10 @@
 hide:
   - toc
 ---
-<div class="hero-header" markdown>
 
-<h1 class="landing-page-h1"></h1>
+# User Guide {.hide-h1}
+
+<div class="hero-header" markdown>
 
 ## This section is for **users**