<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en_US"><generator uri="https://jekyllrb.com/" version="4.4.1">Jekyll</generator><link href="https://fungalgenomes.org/feed.xml" rel="self" type="application/atom+xml" /><link href="https://fungalgenomes.org/" rel="alternate" type="text/html" hreflang="en_US" /><updated>2026-09-07T17:45:17+00:00</updated><id>https://fungalgenomes.org/feed.xml</id><title type="html">The Hyphal Tip</title><subtitle>Tools, data, and notes for researchers working on fungal and oomycete genomes.</subtitle><author><name>Jason Stajich</name></author><entry><title type="html">Rebuilding fungalgenomes.org</title><link href="https://fungalgenomes.org/notes/2026/09/site-rebuild/" rel="alternate" type="text/html" title="Rebuilding fungalgenomes.org" /><published>2026-09-07T00:00:00+00:00</published><updated>2026-09-07T00:00:00+00:00</updated><id>https://fungalgenomes.org/notes/2026/09/site-rebuild</id><content type="html" xml:base="https://fungalgenomes.org/notes/2026/09/site-rebuild/"><![CDATA[<p>For a while fungalgenomes.org returned a GitHub 404 for every request, which is
an unhelpful failure mode: DNS resolved, the certificate was valid, and Pages
reported the site as built. Everything looked healthy except the part that
mattered.</p>

<p>The cause was the publishing source. Pages was configured to build the
<code class="language-plaintext highlighter-rouge">gh-pages</code> branch from the <code class="language-plaintext highlighter-rouge">/docs</code> subdirectory, but the site itself —
<code class="language-plaintext highlighter-rouge">_config.yml</code>, <code class="language-plaintext highlighter-rouge">index.md</code>, the stylesheet — sat at the branch root, one level
above what Pages was serving. The only file inside <code class="language-plaintext highlighter-rouge">/docs</code> was a stub page at
<code class="language-plaintext highlighter-rouge">docs/wrifo/index.md</code>. That page worked fine at <code class="language-plaintext highlighter-rouge">/wrifo/</code>; nothing else existed
as far as the server was concerned. Without a <code class="language-plaintext highlighter-rouge">_config.yml</code> in the publishing
root, Jekyll was not applying a theme either.</p>

<h2 id="what-changed">What changed</h2>

<p>The site is now built by a GitHub Actions workflow rather than by the legacy
Pages builder, and everything lives on <code class="language-plaintext highlighter-rouge">main</code> — the <code class="language-plaintext highlighter-rouge">gh-pages</code> branch is gone.
That combination removes the class of bug entirely: with a workflow build there
is no “publishing source” setting to get out of step with the repository, because
the branch that gets published is the one named in the workflow file.</p>

<p>The site also has a <code class="language-plaintext highlighter-rouge">CNAME</code> file tracked in git rather than relying only on the
repository setting. Changing the Pages source through the API silently clears the
custom domain, so it is worth having in a file that gets republished every build.</p>

<p>The stock remote theme is gone. Layouts, includes, and the stylesheet are all in
the repository now, which makes the site slower to change casually and easier to
change deliberately.</p>

<h2 id="contributing">Contributing</h2>

<p>The site is plain Jekyll. To preview changes locally:</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bundle install
bundle exec jekyll serve
</code></pre></div></div>

<p>Posts go in <code class="language-plaintext highlighter-rouge">_posts</code> as <code class="language-plaintext highlighter-rouge">YYYY-MM-DD-slug.md</code>. Pages go at the top level with a
<code class="language-plaintext highlighter-rouge">permalink</code> in their front matter. Sections listed in the <code class="language-plaintext highlighter-rouge">nav</code> key of
<code class="language-plaintext highlighter-rouge">_config.yml</code> show up both in the header and as tips on the branching hypha on
the home page. Pushing to <code class="language-plaintext highlighter-rouge">main</code> publishes.</p>]]></content><author><name>Jason Stajich</name></author><summary type="html"><![CDATA[For a while fungalgenomes.org returned a GitHub 404 for every request, which is an unhelpful failure mode: DNS resolved, the certificate was valid, and Pages reported the site as built. Everything looked healthy except the part that mattered.]]></summary></entry></feed>