<p>It appears the issue is in the URL used to access the documents in the blog post excerpt. First of all, the URL should begin with a <code>/</code> since the <code>assets</code> folder is at the root of the site project. However (and most importantly), I also had to add the <code>baseurl</code> to the file URL as shown below:</p>
<p>blog post excerpt:</p>
<pre><code>&lt;ul style=&quot;list-style-type:none&quot;&gt;
    {% for duck in ducks %}
        &lt;h2&gt;{{ duck.name }}&lt;/h2&gt;
        &lt;li&gt;&lt;a href=&quot;/{{ baseurl }}/assets/v{{ version }}/{{ duck.url }}&quot;&gt;View&lt;/a&gt; | &lt;a href=&quot;/{{ baseurl }}/assets/v{{ version }}/{{ duck.url }}&quot; download&gt;Download&lt;/a&gt;&lt;/li&gt;
    {% endfor %}
&lt;/ul&gt;
</code></pre>
<p>If I weren't building my post entries from a template the link would actually be <code>/{{ site.baseurl }}/assets/v{{ version }}/{{ duck.url }}</code>, but Jinja does not understand the <code>site.baseurl</code> object when rendering the template. To bypass this, I read the value of the predefined GitLab <code>CI_PROJECT_PATH</code> variable and pass it to the template under the name <code>baseurl</code> when rendering.</p>

CC BY-SA 4.0
2020-08-04T06:57:47.753Z
2020-08-04T06:57:47.753Z
avazula
<p>I'm using Jekyll to build a static site and deploy it with GitLab Pages. This site is compounded of posts (contained in the <code>site/_posts</code> folder) and refer to other HTML and Markdown documents that I placed in an <code>assets</code> folder at the project's root, <a href="https://jekyllrb.com/docs/posts/#including-images-and-resources" rel="nofollow noreferrer">as recommended</a> by Jekyll docs.</p>
<p>When I build the website in the pipeline it runs and deploys it successfully to GitLab Pages. However, if I am able to find my posts, the links towards the files allegedly contained in <code>assets</code> return a 404. When I browse the <code>public</code> artifacts file, I can't see said files in the assets folder, even though I put them there before building the site.</p>
<p>What am I missing here? It runs fine when serving locally but as soon as it is deployed on GitLab Pages I can't access the assets file.</p>
<p>project architecture:</p>
<pre><code>site/
|__&gt; _posts/
|____&gt; entry.md
assets/
|__&gt; v{{ version }}/
|____&gt; yellow-ducky.html
|____&gt; black-ducky.md
</code></pre>
<p>.gitlab-ci.yml excerpt:</p>
<pre><code>pages:
  stage: deploy
  tags: [docker-connect]
  script:
    # entry.md is the blog post I want to publish
    - mv entry.md site/_posts/`date +'%Y-%m-%d'`-entry.md
    # reports come from a previous job's artifacts and contain all files I want to place in assets
    - mkdir -p assets assets/v${TAG}
    - mv reports/* assets/v${TAG}/
    # build website
    - gem install bundler
    - cd site
    - bundle install
    - bundle exec jekyll build -d public
    # move built files to the folder where GitLab expects to find them
    - cd .. &amp;&amp; mkdir -p public &amp;&amp; mv site/public/* public/
  artifacts:
    paths:
      - public
</code></pre>
<p>_config.yml excerpt:</p>
<pre><code>title: RubberDucky
email: rubber@duck.io
description: &gt;- # this means to ignore newlines until &quot;baseurl:&quot;
  This is the place where to find all info you need about rubber ducks. 
baseurl: &quot;/toys/rubberduck&quot; # the subpath of your site, e.g. /blog
url: &quot;https://gitlab.troubleshoot.io&quot; # the base hostname &amp; protocol for your site, e.g. http://example.com
# Build settings
theme: minima
plugins:
  - jekyll-feed
</code></pre>
<p>blog post excerpt:</p>
<pre><code>&lt;ul style=&quot;list-style-type:none&quot;&gt;
    {% for duck in ducks %}
        &lt;h2&gt;{{ duck.name }}&lt;/h2&gt;
        &lt;li&gt;&lt;a href=&quot;assets/v{{ version }}/{{ duck.url }}&quot;&gt;View&lt;/a&gt; | &lt;a href=&quot;assets/v{{ version }}/{{ duck.url }}&quot; download&gt;Download&lt;/a&gt;&lt;/li&gt;
    {% endfor %}
&lt;/ul&gt;
</code></pre>

<continuous-integration><gitlab><yaml><jekyll>
How to render assets when building a static website with GitLab Pages and Jekyll
avazula
# How to render assets when building a static website with GitLab Pages and Jekyll

(Asked by: username_0 on 2020-08-03)

I'm using Jekyll to build a static site and deploy it with GitLab Pages. This site is compounded of posts (contained in the site/_posts folder) and refer to other HTML and Markdown documents that I placed in an assets folder at the project's root, as recommended by Jekyll docs.
When I build the website in the pipeline it runs and deploys it successfully to GitLab Pages. However, if I am able to find my posts, the links towards the files allegedly contained in assets return a 404. When I browse the public artifacts file, I can't see said files in the assets folder, even though I put them there before building the site.
What am I missing here? It runs fine when serving locally but as soon as it is deployed on GitLab Pages I can't access the assets file.
project architecture:
site/
|__> _posts/
|____> entry.md
assets/
|__> v{{ version }}/
|____> yellow-ducky.html
|____> black-ducky.md

.gitlab-ci.yml excerpt:
pages:
  stage: deploy
  tags: [docker-connect]
  script:
    # entry.md is the blog post I want to publish
    - mv entry.md site/_posts/`date +'%Y-%m-%d'`-entry.md
    # reports come from a previous job's artifacts and contain all files I want to place in assets
    - mkdir -p assets assets/v${TAG}
    - mv reports/* assets/v${TAG}/
    # build website
    - gem install bundler
    - cd site
    - bundle install
    - bundle exec jekyll build -d public
    # move built files to the folder where GitLab expects to find them
    - cd .. && mkdir -p public && mv site/public/* public/
  artifacts:
    paths:
      - public

_config.yml excerpt:
title: RubberDucky
email: rubber@duck.io
description: >- # this means to ignore newlines until "baseurl:"
  This is the place where to find all info you need about rubber ducks. 
baseurl: "/toys/rubberduck" # the subpath of your site, e.g. /blog
url: "https://gitlab.troubleshoot.io" # the base hostname & protocol for your site, e.g. http://example.com
# Build settings
theme: minima
plugins:
  - jekyll-feed

blog post excerpt:

    {% for duck in ducks %}
        {{ duck.name }}
        View | Download
    {% endfor %}

**Tags:** continuous-integration, gitlab, yaml, jekyll


---

## 1 answers

### Answer by username_0 on 2020-08-04. Score: 1

It appears the issue is in the URL used to access the documents in the blog post excerpt. First of all, the URL should begin with a / since the assets folder is at the root of the site project. However (and most importantly), I also had to add the baseurl to the file URL as shown below:
blog post excerpt:

    {% for duck in ducks %}
        {{ duck.name }}
        View | Download
    {% endfor %}


If I weren't building my post entries from a template the link would actually be /{{ site.baseurl }}/assets/v{{ version }}/{{ duck.url }}, but Jinja does not understand the site.baseurl object when rendering the template. To bypass this, I read the value of the predefined GitLab CI_PROJECT_PATH variable and pass it to the template under the name baseurl when rendering.


---

