(CAT-1930) - fix build dir for jekyll gh-actions, links and stying

puppetlabs · Jul 5, 2024 · 8f45b3f · 8f45b3f
1 parent 2c8b9cf
commit 8f45b3f
Show file tree

Hide file tree

Showing 7 changed files with 33 additions and 30 deletions.
diff --git a/.github/workflows/jekyll-gh-pages.yml b/.github/workflows/jekyll-gh-pages.yml
@@ -32,7 +32,7 @@ jobs:
       - name: Build with Jekyll
         uses: actions/jekyll-build-pages@v1
         with:
-          source: ./
+          source: ./docs/
           destination: ./_site
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

diff --git a/docs/_config.yml b/docs/_config.yml
@@ -8,6 +8,7 @@ gfm_quirks: paragraph_end
 lsi: false
 safe: true
 incremental: false
+url: https://puppetlabs.github.io/rspec-puppet
 gist:
     noscript: false
 markdown: kramdown
diff --git a/docs/_layouts/base.html b/docs/_layouts/base.html
@@ -12,13 +12,13 @@
     <meta name="author" content="">    
     <link href='//fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
     <!-- Global CSS -->
-    <link rel="stylesheet" href="/assets/plugins/bootstrap/css/bootstrap.min.css">   
+    <link rel="stylesheet" href="{{site.url}}/assets/plugins/bootstrap/css/bootstrap.min.css">   
     <!-- Plugins CSS -->    
-    <link rel="stylesheet" href="/assets/plugins/font-awesome/css/font-awesome.css">
+    <link rel="stylesheet" href="{{site.url}}/assets/plugins/font-awesome/css/font-awesome.css">
 
     <!-- Theme CSS -->
-    <link id="theme-style" rel="stylesheet" href="/assets/css/styles.css">
-    <link rel="stylesheet" href="/assets/css/monokai.css">
+    <link id="theme-style" rel="stylesheet" href="{{site.url}}/assets/css/styles.css">
+    <link rel="stylesheet" href="{{site.url}}/assets/css/monokai.css">
     <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
     <!--[if lt IE 9]>
       <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
@@ -40,7 +40,7 @@ <h1 class="logo">
                     </h1>
                 </div><!--//branding-->
                 <ol class="breadcrumb">
-                    <li><a href="/">Home</a></li>
+                    <li><a href="{{site.url}}">Home</a></li>
 {% for crumb in page.breadcrumbs %}
                     <li><a href="{{ crumb.path }}">{{ crumb.name }}</a></li>
 {% endfor %}

diff --git a/docs/_layouts/cards.html b/docs/_layouts/cards.html
@@ -12,13 +12,13 @@
     <meta name="author" content="">    
     <link href='//fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
     <!-- Global CSS -->
-    <link rel="stylesheet" href="/assets/plugins/bootstrap/css/bootstrap.min.css">   
+    <link rel="stylesheet" href="{{site.url}}/assets/plugins/bootstrap/css/bootstrap.min.css">   
     <!-- Plugins CSS -->    
-    <link rel="stylesheet" href="/assets/plugins/font-awesome/css/font-awesome.css">
+    <link rel="stylesheet" href="{{site.url}}/assets/plugins/font-awesome/css/font-awesome.css">
 
     <!-- Theme CSS -->
-    <link rel="stylesheet" href="/assets/css/monokai.css">
-    <link id="theme-style" rel="stylesheet" href="/assets/css/styles.css">
+    <link rel="stylesheet" href="{{site.url}}/assets/css/monokai.css">
+    <link id="theme-style" rel="stylesheet" href="{{site.url}}/assets/css/styles.css">
     <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
     <!--[if lt IE 9]>
       <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>

diff --git a/docs/documentation/index.md b/docs/documentation/index.md
@@ -2,59 +2,59 @@
 layout: cards
 title: Documentation
 icon: fa fa-files-o
-cards:
+cards:  
     -
         title: Getting Started
         text:
-        path: /documentation/setup/
+        path: rspec/documentation/setup/
         icon: fa fa-toggle-on
         colour: green
     -
         title: Configuration
         text:
-        path: /documentation/configuration/
+        path: rspec/documentation/configuration/
         icon: fa fa-wrench
         colour: blue
     -
         title: Testing Classes
         text:
-        path: /documentation/classes/
+        path: rspec/documentation/classes/
         icon: fa fa-book
         colour: pink
     -
         title: Testing Defined Types
         text:
-        path: /documentation/defined_types/
+        path: rspec/documentation/defined_types/
         icon: fa fa-copy
         colour: purple
     -
         title: Testing Functions
         text:
-        path: /documentation/functions/
+        path: rspec/documentation/functions/
         icon: fa fa-superscript
         colour: red
     -
         title: Testing Hosts
         text:
-        path: /documentation/hosts/
+        path: rspec/documentation/hosts/
         icon: fa fa-server
         colour: orange
     -
         title: Testing Types
         text:
-        path: /documentation/types/
+        path: rspec/documentation/types/
         icon: fa fa-puzzle-piece
         colour: blue
     -
         title: Testing Type Aliases
         text:
-        path: /documentation/type_aliases/
+        path: rspec/documentation/type_aliases/
         icon: fa fa-exchange
         colour: pink
     -
         title: Coverage Reports
         text:
-        path: /documentation/coverage/
+        path: rspec/documentation/coverage/
         icon: fa fa-map-o
         colour: purple
 ---
diff --git a/docs/index.html b/docs/index.html
@@ -1,3 +1,5 @@
+--- 
+
 <!DOCTYPE html>
 <!--[if IE 8]> <html lang="en" class="ie8"> <![endif]-->  
 <!--[if IE 9]> <html lang="en" class="ie9"> <![endif]-->  
@@ -12,13 +14,13 @@
     <meta name="author" content="">    
     <link href='//fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
     <!-- Global CSS -->
-    <link rel="stylesheet" href="assets/plugins/bootstrap/css/bootstrap.min.css">   
+    <link rel="stylesheet" href="{{ site.url }}/assets/plugins/bootstrap/css/bootstrap.min.css">   
     <!-- Plugins CSS -->    
-    <link rel="stylesheet" href="assets/plugins/font-awesome/css/font-awesome.css">
-    <link rel="stylesheet" href="assets/css/monokai.css">
+    <link rel="stylesheet" href="{{ site.url }}/assets/plugins/font-awesome/css/font-awesome.css">
+    <link rel="stylesheet" href="{{ site.url }}/assets/css/monokai.css">
 
     <!-- Theme CSS -->
-    <link id="theme-style" rel="stylesheet" href="assets/css/styles.css">
+    <link id="theme-style" rel="stylesheet" href="{{ site.url }}/assets/css/styles.css">
     <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
     <!--[if lt IE 9]>
       <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
@@ -54,9 +56,9 @@ <h5>(The rest is a bit more difficult though)</h5>
 $ cd your-module
 $ rspec-puppet-init
                         </code></pre></div>
-                    <p>Then continue on to the <a href="/tutorial/">tutorial!</a></p>
+                    <p>Then continue on to the <a href="{{ site.url }}/tutorial">tutorial!</a></p>
                     <div class="cta-container">
-                        <a class="btn btn-primary btn-cta" href="https://github.com/rodjek/rspec-puppet/" target="_blank"><i class="fa fa-github"></i> View on GitHub</a>
+                        <a class="btn btn-primary btn-cta" href="https://github.com/puppetlabs/rspec-puppet" target="_blank"><i class="fa fa-github"></i> View on GitHub</a>
                     </div><!--//cta-container-->
                 </div><!--//intro-->
                 <div id="cards-wrapper" class="cards-wrapper row">
@@ -67,7 +69,7 @@ <h5>(The rest is a bit more difficult though)</h5>
                             </div><!--//icon-holder-->
                             <h3 class="title">Tutorial</h3>
                             <p class="intro">A step-by-step introduction to behaviour-driven Puppet development</p>
-                            <a class="link" href="/tutorial/"><span></span></a>
+                            <a class="link" href="{{ site.url }}/tutorial"><span></span></a>
                         </div><!--//item-inner-->
                     </div><!--//item-->
                     <div class="item item-pink item-2 col-md-4 col-sm-6 col-xs-6">
@@ -77,7 +79,7 @@ <h3 class="title">Tutorial</h3>
                             </div><!--//icon-holder-->
                             <h3 class="title">Documentation</h3>
                             <p class="intro">Everything you need to know</p>
-                            <a class="link" href="/documentation/"><span></span></a>
+                            <a class="link" href="{{ site.url }}/documentation/"><span></span></a>
                         </div><!--//item-inner-->
                     </div><!--//item-->
                     <div class="item item-purple col-md-4 col-sm-6 col-xs-6">
@@ -87,7 +89,7 @@ <h3 class="title">Documentation</h3>
                             </div><!--//icon-holder-->
                             <h3 class="title">Changelog</h3>
                             <p class="intro">Check out what's changed in the latest release</p>
-                            <a class="link" href="/changelog/"><span></span></a>
+                            <a class="link" href="{{ site.url }}/changelog/"><span></span></a>
                         </div><!--//item-inner-->
                     </div><!--//item-->
                 </div><!--//cards-->

diff --git a/docs/tutorial/index.md b/docs/tutorial/index.md
@@ -56,7 +56,7 @@ _This is not intended to be an RSpec tutorial, just an explanation of how to
 use the extended functionality that rspec-puppet provides.  If you are not
 familiar with the basics of RSpec, I highly recommend you take some time before
 continuing to read through the [RSpec 
-documentation](https://www.relishapp.com/rspec)._
+documentation](https://rspec.info/documentation/)._
 
 Lets say you're writing tests for a `logrotate::rule` type that does two
 things: