# \[SOLVED\] Github : Page build failed: Symlink does not exist

**URL:** <https://talk.jekyllrb.com/t/solved-github-page-build-failed-symlink-does-not-exist/1623>\
**Category:** Help\
**Created:** [March 22, 2018, 3:53pm UTC](https://talk.jekyllrb.com/t/solved-github-page-build-failed-symlink-does-not-exist/1623 "2018-03-22T15:53:18Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![typematrix](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/typematrix/32/891_2.png) [@typematrix](https://talk.jekyllrb.com/u/typematrix)\
**Post date:** [March 22, 2018, 3:53pm UTC](https://talk.jekyllrb.com/t/solved-github-page-build-failed-symlink-does-not-exist/1623/1 "2018-03-22T15:53:18Z")

</div>

Hi

I have been using jekyll for a blog on github for some time with no issues.  
I tried to add a post to my jekyll blog on github. This is first post i have added since mid February.  
I have only created a post changed no other files and the blog will not build now on github.  
Something appears to have changed upstream  
I am using 3.6.2 and theme minima. When i run locally using bundle exec jekyll serve, everything builds correctly, i.e i cannot recreate error locally.

The information from github by mail is as follows:

**The page build failed for the `master` branch with the following error:**  
**A file was included in `/_layouts/default.html` that is a symlink or does not exist in your `_includes` directory**  
[https://help.github.com/articles/page-build-failed-file-is-a-symlink/](https://help.github.com/articles/page-build-failed-file-is-a-symlink/)

There are 3 links in my /\_layouts/default.html to header footer and head.html. , Header and footer exist  
in my \_includes. so i created a head.html but still got the page build error.

How do I proceed from here?  
My jekyll blog on github is here

> **[Gavin Lyons](https://gavinlyonsrepo.github.io/)**
>
> This blog documents open source work in the github repository named gavinlyonsrepo.

Regards.

---

<div class="post-metadata">

**Author:** ![ashmaroli](https://avatars.discourse-cdn.com/v4/letter/a/df705f/32.png) [@ashmaroli](https://talk.jekyllrb.com/u/ashmaroli)\
**Post date:** [March 22, 2018, 5:42pm UTC](https://talk.jekyllrb.com/t/solved-github-page-build-failed-symlink-does-not-exist/1623/2 "2018-03-22T17:42:27Z")

</div>

The reason is the recent versions of Minima no longer has `includes/icon-github.html`  
Please refer README of  
the latest version of Minima and update the following line accordingly…

> <https://github.com/gavinlyonsrepo/gavinlyonsrepo.github.io/blob/00caf2f0186e5c6eedcb0ef73e258e55744a9cc6/_includes/footer.html#L50>

---

<div class="post-metadata">

**Author:** ![typematrix](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/typematrix/32/891_2.png) [@typematrix](https://talk.jekyllrb.com/u/typematrix)\
**Post date:** [March 22, 2018, 8:06pm UTC](https://talk.jekyllrb.com/t/solved-github-page-build-failed-symlink-does-not-exist/1623/3 "2018-03-22T20:06:26Z")

</div>

Hi  
thanks for reply  
I cut all reference to git-hub icon but it did not work.  
I see i am using minima 2.1.1

---

<div class="post-metadata">

**Author:** ![ashmaroli](https://avatars.discourse-cdn.com/v4/letter/a/df705f/32.png) [@ashmaroli](https://talk.jekyllrb.com/u/ashmaroli)\
**Post date:** [March 23, 2018, 3:41am UTC](https://talk.jekyllrb.com/t/solved-github-page-build-failed-symlink-does-not-exist/1623/4 "2018-03-23T03:41:08Z")

</div>

@typematrix When you push to GitHub Pages, the environment changes irrespective of your Gemfile. GHP always uses a single set of gems and their current versions are listed [here](https://pages.github.com/versions/).

To reproduce the errors locally, bundle your site with the latest version of the `github-pages` gem and try building again…

```diff
- gem "jekyll", "~> 3.4.2"
- gem "minima", "~> 2.0"
-
- #gem "github-pages", group: :jekyll_plugins
+ # gem "jekyll", "~> 3.4.2"
+ # gem "minima", "~> 2.0"
+
+ gem "github-pages", group: :jekyll_plugins

```

then run

```auto
bundle update
bundle exec jekyll build

```

---

<div class="post-metadata">

**Author:** ![typematrix](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/typematrix/32/891_2.png) [@typematrix](https://talk.jekyllrb.com/u/typematrix)\
**Post date:** [March 23, 2018, 3:12pm UTC](https://talk.jekyllrb.com/t/solved-github-page-build-failed-symlink-does-not-exist/1623/5 "2018-03-23T15:12:26Z")

</div>

**SOLVED**

Thanks for help

I updated to minima 2.4.0 as per instructions and was able to generate the error, with proper error messages locally. The issue was with reference to the github icon as you said , I even had to remove a commented out reference to it from footer.html for it to build!?! Everything working now, solved, thanks.