Som si istý, že som videl v projektoch blogov Jekyll s viacerými zdrojovými dokumentmi, ako napríklad _posts
a _pages
, ale source
v parametri _config.yml
súbor môže mať iba 1 adresár ako argument, a ani pole ani medzeru oddelenú reťazcom adresárov nepracuje.
Nedorozumím sa zmyslu source
parameter? "Očakávam, že budú použité na sledovanie, ktoré zmeny" spúšťajú zostavenie a ktoré súbory sa majú vytvoriť.
Tiež mám fragmenty ako napr about.md
ktoré môžu byť zahrnuté na iných stránkach. Aké je najlepšie umiestnenie pre súbory, ako je tento?
odpovede:
1 pre odpoveď č. 1Na source
konfigurácia odkazuje na váš <project_root>
, nie jednotlivé adresáre v rámci koreňového projektu. V predvolenom nastavení je nastavený na aktuálny adresár (miesto, z ktorého používate jekyll build (or) serve
.
Jekyll štandardne sleduje všetky vnorené súbory a adresáre v zdrojovom adresári.
about.md
nemá byť považovaný za fragment, ktorý sa má zahrnúť do iných súborov. Je to plnohodnotná "stránka", ktorá by sa mohla vykresliť _site/about.html
alebo _site/about/index.html
v závislosti od nastavení permalink.
Fragmenty, ktoré majú byť zahrnuté na iných stránkach, žijú v rámci _includes
adresára a sú vložené prostredníctvom konštrukcie Liquid {% include <fragment-filename>.html %}
Iný ako _layouts
, _includes
a _sass
, adresáre, ktoré začínajú podčiarknutím, sú Jekyllom ignorované, pokiaľ nie konfigurácia Jekyll ich vidieť ako "zbierky". _posts
je preddefinovaný a pevne zadaný adresár zberu.
Viac informácií o Jekyll nájdete v oficiálnej dokumentácii na adrese https://jekyllrb.com