注記このページはまだ翻訳されていないため、代わりに英語版が表示されます。協力していただけませんか？ 貢献
Directory Structure
By default, Hugo looks for Markdown files in the /content directory, and the structure of the directory determines the final output structure of your website.
Take this site as an example:
-
- _index.md ← / (homepage)
-
- _index.md ← /docs/
-
- index.md ← /docs/getting-started/
-
- _index.md ← /docs/guide/
- organize-files.md ← /docs/guide/organize-files/
-
- _index.md ← /blog/
- post.md ← /blog/post/
-
- index.md ← /docs/article/
Each _index.md file is the index page for the corresponding section. The other Markdown files are regular pages, placed directly in the section directory, or nested in their own sub-directory.
Configure Content Directory
By default, the root /content directory is used by Hugo to build the site.
If you need to use a different directory for content, for example /docs, this can be done by setting the contentDir parameter in the site configuration hugo.yaml.
Resources
In addition to text content, Hugo supports a wide range of additional resources, such as images, animations, vector graphics, videos, PDF, JSON, CSV, and many more medias and data formats.
注記For the FreeCAD website, page bundles are used, so it is easier to organize large amount of content and resources in a nested structure.
Additionally, each language is organized into its own root content directory (e.g
/content/en/). Resources only need to go into the default language site (enfor English), as other languages are linked automatically.
Page bundles
To add resources, the easiest way is to place these files together in the same directory as the Markdown file.
The page bundles feature of Hugo allows to organize content and resource files neatly. To achieve that, turn the my-page.md file into a directory my-page, put the content into a Markdown file named index.md, and put the resource files inside the my-page directory.
For example, add an image file image.webp alongside the my-page.md file:
-
-
- my-page.md
- image.webp
-
Then, can use the following Markdown syntax to add the image to the content:
Static and Assets
Alternatively, it is possible to place resources in the static and assets root directories, which will make the resources available for all pages:
-
-
- image.webp
-
-
-
- my-page.md
-
注記The path for a resource in the static directory begins with a slash
/.
