在GitHub Pages上用文件夹管理Jekyll页面的问题

这个问题的核心是页面URL路径（由permalink定义）和静态文件的实际生成路径不匹配导致的。你的cv.md最终URL是/cv/，但my_cv.pdf实际被Jekyll生成到/_pages/cv/my_cv.pdf（因为它在_pages/cv子文件夹里），所以相对链接my_cv.pdf会被浏览器解析为/cv/my_cv.pdf，自然找不到文件。

下面给你几个实用的解决方案，按推荐程度排序：

方案1：将静态文件移到独立的静态资源目录（最推荐） #

Jekyll默认会把根目录下的assets文件夹视为静态资源目录，里面的文件会原样复制到_site/assets下，不会被修改路径。你可以：

1. 在根目录创建assets/cv文件夹，把my_cv.pdf放进去。
2. 在cv.md里修改链接为：

   [Download my CV](/assets/cv/my_cv.pdf)
   

这种方法的好处是路径清晰，不管页面的permalink怎么设置，链接都不会出错，也符合Jekyll的最佳实践。

方案2：调整文件结构，让静态文件和生成的页面同目录 #

如果你希望保持CV相关文件放在一起，可以把cv子文件夹移出_pages，直接放到根目录：

1. 把_pages/cv整个文件夹移到根目录，现在结构是：根目录→cv→cv.md、my_cv.pdf。
2. 在_config.yml的include里加上cv：

   include:
     - _pages
     - cv
   

3. 保留原来的defaults配置，cv.md的permalink还是/cv/。
   这样Jekyll会把my_cv.pdf复制到_site/cv/下，和生成的index.html（对应/cv/）在同一目录，此时相对链接[Download my CV](my_cv.pdf)就能正确指向/cv/my_cv.pdf了。

方案3：使用Jekyll的变量构建正确路径 #

如果不想调整文件结构，可以用Jekyll的site.baseurl变量来生成绝对路径：
在cv.md里把链接改成：

[Download my CV]({{ site.baseurl }}/_pages/cv/my_cv.pdf)

这种方法不需要移动文件，但URL里会出现/_pages/，可能不太美观，适合临时解决问题。

方案4：修改permalink配置匹配文件路径 #

你可以单独给cv.md设置更精确的permalink，让页面URL和文件的实际位置对应：

1. 在cv.md的 front matter 里单独设置permalink（覆盖defaults的全局设置）：

   ---
   permalink: /cv/cv/
   ---
   

2. 此时页面URL是/cv/cv/，相对链接my_cv.pdf会指向/cv/cv/my_cv.pdf，而Jekyll会把my_cv.pdf生成到/_pages/cv/my_cv.pdf，所以还需要把my_cv.pdf移到_pages/cv/cv文件夹里，这样路径就匹配了。不过这种方法会让URL多一层，不太推荐。

总结下来，方案1和方案2是最符合Jekyll设计思路的，选一个适合你的就行~

内容的提问来源于stack exchange，提问作者Alireza M. Kamel