Make main page look slimmer

Author: michaliskambi

src/_layouts/default.html

@@ -16,13 +16,19 @@
           <h1 class="project-name">{{ site.title | default: site.github.repository_name }}</h1>
           <h2 class="project-tagline">{{ site.description | default: site.github.project_tagline }}</h2>
           {% if site.show_downloads %}
+            <!--
+            Commented out: make header look slimmer.
             <b>Stable version ({{ site.pasdoc.stable_download_version }}):</b>
             <br>
+            -->
+
             <a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-win64.zip" class="btn">Windows (x86_64)</a>
             <a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-linux-x86_64.tar.gz" class="btn">Linux (x86_64)</a>
             <a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-linux-arm.tar.gz" class="btn">Linux (Arm, 32-bit) (Raspberry Pi)</a>
             <a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-darwin-x86_64.zip" class="btn">macOS (x86_64)</a>
 
+            <!--
+            Commented out: make header look slimmer.
             <br>
             <br>
 
@@ -34,12 +40,16 @@ <h2 class="project-tagline">{{ site.description | default: site.github.project_t
             <a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-linux-aarch64.tar.gz" class="btn">Linux (Aarch64, 64-bit) (Raspberry Pi, PineTab2)</a>
             <a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-darwin-x86_64.zip" class="btn">macOS (x86_64)</a>
             <a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-darwin-x86_64.zip" class="btn">macOS (Aarch64)</a>
+            -->
           {% endif %}
           {% if site.github.is_project_page %}
+            <!--
+            Commented out: make header look slimmer.
             <br>
             <br>
 
             <a href="{{ site.pasdoc.repository_url }}" class="btn">Source code (build with FPC or Delphi)</a>
+            -->
           {% endif %}
         </section>
         {% endif %}

src/_sass/pasdoc.scss

@@ -100,6 +100,17 @@
   /* background: #B2D2E1 !important; */
   background: #475a94 !important;
   /* background: #4e4b42 !important; */
+
+  h2 {
+    /* smaller margin than theme default, to be closer to "PasDoc" header */
+    margin-top: 0.1rem;
+  }
+
+  a.btn {
+    /* margin on right, not left, to make 2nd line of buttons aligned with 1st */
+    margin-left: 0;
+    margin-right: 0.5rem;
+  }
 }
 
 /* Make sure <pre> is not too wide, like on ListTags page with wide <pre> element */

src/index.asciidoc

@@ -13,26 +13,19 @@ and / or in dedicated "description files". Numerous output formats are supported
 
 This is a _free and open source software_.
 //PasDoc itself is written using modern Object Pascal and can be build using FPC or Delphi.
-We https://castle-engine.io/donate[appreciate your donations (Michalis, maintainer of PasDoc, also makes Castle Game Engine)], esp. if you use PasDoc in a commercial project. This helps us to continue developing and improving PasDoc.
-
-## Download
-
-Download:
-
-* Latest *stable* PasDoc release https://github.com/pasdoc/pasdoc/releases/latest[can be downloaded from here].
 
-* Latest *unstable* (automatic build after every commit, published once automatic tests pass) release https://github.com/pasdoc/pasdoc/releases/tag/snapshot[is available here ("snapshot" releases)].
-
-You can watch our https://github.com/pasdoc/pasdoc/releases[releases page] or https://github.com/pasdoc/pasdoc/discussions/categories/announcements[announcements category in our discussions] to be notified about a new release.
+We https://castle-engine.io/donate[appreciate your donations (Michalis, maintainer of PasDoc, also makes Castle Game Engine)], esp. if you use PasDoc in a commercial project. This helps us to continue developing and improving PasDoc.
 
-## Tutorial
+## Basic Usage
 
 Put comments before the identifiers in your Pascal source code. Like this:
 
 ```pascal
 { My amazing unit. }
 unit MyUnit;
+
 interface
+
 type
   { My amazing class. }
   TMyClass = class
@@ -42,6 +35,7 @@ type
     { My amazing property. }
     property MyProperty: string read GetMyProperty;
   end;
+
 implementation
 ...
 end.
@@ -58,20 +52,20 @@ You can also use the GUI interface, see link:PasDocGui[PasDoc GUI].
 
 ## Examples
 
-- This is https://pasdoc.github.io/autodoc/html/index.html[PasDoc's own documentation in the HTML format].
+- Take a look at https://pasdoc.github.io/autodoc/html/index.html[PasDoc's own documentation (in the HTML format)].
 
-- See also link:PasDocAutoDoc[PasDoc's own documentation in all the formats] .
+- See link:PasDocAutoDoc[PasDoc's own documentation in all the formats].
 
 - See link:ProjectsUsingPasDoc[Projects using PasDoc] for links to larger real-world
 examples of how documentation generated by PasDoc looks like.
 
-## More usage information: output formats, command-line options, examples
+## Features
 
 For more information on how to document your source code see:
 
 - link:WhereToPlaceComments[Where To Place Comments]
 - link:WritingDocumentation[Writing Documentation]
-- link:SupportedTags[Supported Tags].
+- link:SupportedTags[Supported Tags]
 
 Available output formats:
 
@@ -85,8 +79,17 @@ Available output formats:
 Check out the link:CommandLine[CommandLine] to get a better feeling
 for how PasDoc works.
 
-You may also be interested in the list of
-link:AdvancedFeatures[AdvancedFeatures] of PasDoc.
+See also the list of link:AdvancedFeatures[AdvancedFeatures] of PasDoc.
+
+## All Downloads (Stable and Unstable)
+
+Download:
+
+* Latest *stable* PasDoc release https://github.com/pasdoc/pasdoc/releases/latest[can be downloaded from here].
+
+* Latest *unstable* (automatic build after every commit, published once automatic tests pass) release https://github.com/pasdoc/pasdoc/releases/tag/snapshot[is available here ("snapshot" releases)].
+
+You can watch our https://github.com/pasdoc/pasdoc/releases[releases page] or https://github.com/pasdoc/pasdoc/discussions/categories/announcements[announcements category in our discussions] to be notified about a new release.
 
 ## Get involved