# Website generated by Franklin (and hosted on GitHub) is not rendering properly

**URL:** <https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827>\
**Category:** Web Stack\
**Tags:** github, franklin\
**Created:** [November 5, 2023, 6:01pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827 "2023-11-05T18:01:07Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![eduardo-zambrano](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/eduardo-zambrano/32/38099_2.png) [@eduardo-zambrano](https://discourse.julialang.org/u/eduardo-zambrano)\
**Post date:** [November 5, 2023, 6:01pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/1 "2023-11-05T18:01:07Z")

</div>

Hi everyone,

I have a website made with Franklin that looks good locally. Unfortunately, the one that is deployed through `gh-pages` on GitHub is missing most of the formatting, plus the links to the other parts of the website do not work. This is what it looks like when i use `serve()` locally:

 ![Screenshot 2023-11-05 at 9.21.43 AM](https://global.discourse-cdn.com/julialang/original/3X/e/f/efae7be6e6e2ad7571a0a344fb5a7ca344f79f7d.png)

And this is what it looks like on GitHub Pages:

 ![Screenshot 2023-11-05 at 9.21.53 AM](https://global.discourse-cdn.com/julialang/original/3X/0/2/02361e78ec9bc213f1e1d1cbbfb0f52f726a0cd9.png)

I’m sure that the problem is some basic issue with the file structure but I can’t figure out what (I’m very new to web hosting on GitHub), especially since the file structure was generated automatically by Franklin.

For reference,

- my `config.md` 's file has `prepath = "equistatlab"`.

- My GitHub Pages site is currently being built from the `gh-pages` /(root) branch.

- The GitHub files sit here: [GitHub - eduardo-zambrano/equistatlab: Documenting research on the econometrics of inequality-sensitive treatment effects estimation.](https://github.com/eduardo-zambrano/equistatlab).

- The website loads from here: [EquiStat Lab](https://eduardo-zambrano.github.io/equistatlab/).

- My local file structure is shown below:  

Any help is gratefully appreciated.

---

<div class="post-metadata">

**Author:** ![oheil](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/oheil/32/220745_2.png) [@oheil](https://discourse.julialang.org/u/oheil)\
**Post date:** [November 5, 2023, 6:39pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/2 "2023-11-05T18:39:18Z")

</div>

The styles (jtd.css) do not load:

 ![image](https://global.discourse-cdn.com/julialang/original/3X/4/f/4ff47b7525c1019e8ff721048e1616bae0649b06.png)

I have no experience with Franklin and github hosted web pages, so I can’t tell more.

---

<div class="post-metadata">

**Author:** ![eduardo-zambrano](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/eduardo-zambrano/32/38099_2.png) [@eduardo-zambrano](https://discourse.julialang.org/u/eduardo-zambrano)\
**Post date:** [November 5, 2023, 7:51pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/3 "2023-11-05T19:51:44Z")

</div>

Thank you. I see. Those resources are there, but not where the computer is looking for it. For example, `logo.png` is at `https://eduardo-zambrano.github.io/equistatlab/assets/logo.png` but the computer is looking for it at `https://eduardo-zambrano.github.io/assets/logo.png`. Same with `jtd.css`. The machine is looking for it at `https://eduardo-zambrano.github.io/css/jtd.css` but `jtd.css` is at `https://eduardo-zambrano.github.io/equistatlab/css/jtd.css`.

---

<div class="post-metadata">

**Author:** ![mkitti](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mkitti/32/12459_2.png) [@mkitti](https://discourse.julialang.org/u/mkitti)\
**Post date:** [November 5, 2023, 7:58pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/4 "2023-11-05T19:58:29Z")

</div>

In the meantime, you can checkout the gh-pages branch via git and manually edit the appropriate style tag.

---

<div class="post-metadata">

**Author:** ![eduardo-zambrano](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/eduardo-zambrano/32/38099_2.png) [@eduardo-zambrano](https://discourse.julialang.org/u/eduardo-zambrano)\
**Post date:** [November 5, 2023, 8:31pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/5 "2023-11-05T20:31:10Z")

</div>

Thank you. I manually went through the html pages inside `gh-pages` and changed things like `<link rel="stylesheet" href="/css/jtd.css">` to `<link rel="stylesheet" href="./css/jtd.css">` in many places. Now the website renders correctly. The remaining question is: what do I need to do so that these manual changes are no longer needed the next time I update the site locally?

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [November 5, 2023, 8:32pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/6 "2023-11-05T20:32:30Z")

</div>

I think you are missing the `prepath` argument that is mentioned in the big red box here: [Deploying your website](https://franklinjl.org/workflow/deploy/index.html#creating_a_repo_on_github)

---

<div class="post-metadata">

**Author:** ![eduardo-zambrano](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/eduardo-zambrano/32/38099_2.png) [@eduardo-zambrano](https://discourse.julialang.org/u/eduardo-zambrano)\
**Post date:** [November 5, 2023, 9:24pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/7 "2023-11-05T21:24:35Z")

</div>

Thank you. Your answer makes sense to me. Having said that, I don’t know how to fix the problem. The url for the site is `https://eduardo-zambrano.github.io/equistatlab/`, so in my `config.md` I wrote `prepath = "equistatlab"`, which I think is what I’m supposed to do. Unfortunately, that does not solve the problem, which means I must be writing the information incorrectly in my `config.md` file. Here is the content of my `config.md`: [https://github.com/eduardo-zambrano/equistatlab/blob/main/config.md](https://github.com/eduardo-zambrano/equistatlab/blob/main/config.md).

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [November 6, 2023, 4:53pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/8 "2023-11-06T16:53:42Z")

</div>

@eduardo-zambrano you’re almost there

bring back the `+++` in your config file and you’ll be ok

```julia
+++
author = "Eduardo Zambrano"
mintoclevel = 2

# uncomment and adjust the following line if the expected base URL of your website is something like [www.thebase.com/yourproject/]
# please do read the docs on deployment to avoid common issues: https://franklinjl.org/workflow/deploy/#deploying_your_website
prepath = "equistatlab"

# Add here files or directories that should be ignored by Franklin, otherwise
# these files might be copied and, if markdown, processed by Franklin which
# you might not want. Indicate directories by ending the name with a `/`.
# Base files such as LICENSE.md and README.md are ignored by default.
ignore = ["node_modules/"]

# RSS (the website_{title, descr, url} must be defined to get RSS)
generate_rss = true
website_title = "EquiStat Lab"
website_descr = "Inequality Sensitive Treatment Effect Estimation"
website_url = "https://eduardo-zambrano.github.io/equistatlab/"
+++

<!--
Add here global latex commands to use throughout your pages.
-->
\newcommand{\R}{\mathbb R}
\newcommand{\scal}[1]{\langle #1 \rangle}

```

---

<div class="post-metadata">

**Author:** ![eduardo-zambrano](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/eduardo-zambrano/32/38099_2.png) [@eduardo-zambrano](https://discourse.julialang.org/u/eduardo-zambrano)\
**Post date:** [November 6, 2023, 5:49pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/9 "2023-11-06T17:49:30Z")

</div>

Thank you so much for looking into this @tlienart. I copied the text above inside my `config.md` file to make sure I did not mess anything up, and it still does not work. My response to @oheil above still applies.

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [November 6, 2023, 6:11pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/10 "2023-11-06T18:11:36Z")

</div>

can you try [Update deploy.yml by tlienart · Pull Request #2 · eduardo-zambrano/equistatlab · GitHub](https://github.com/eduardo-zambrano/equistatlab/pull/2) please? your changes are not being deployed properly which you can see here [GitHub - eduardo-zambrano/equistatlab at gh-pages](https://github.com/eduardo-zambrano/equistatlab/tree/gh-pages) (e.g. `index.html` was last updated yesterday while you just made changes to it)

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [November 6, 2023, 7:49pm UTC](https://discourse.julialang.org/t/website-generated-by-franklin-and-hosted-on-github-is-not-rendering-properly/105827/11 "2023-11-06T19:49:39Z")

</div>

Note for onlookers, this is now resolved, it also required small adjustments in the gha deployment file 🙂