From 7405858c07dc331f3872f502ae1f9f3ca7dde1bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?F=C3=A9lix=20L=C3=A9ger?= Date: Mon, 5 May 2025 06:54:37 -0400 Subject: [PATCH] restore makefile --- Makefile | 2 +- content/docs/guide/_index.en.md | 17 +--- content/docs/guide/_index.fr.md | 17 +--- content/docs/guide/advanced/_index.en.md | 21 ----- content/docs/guide/advanced/_index.fr.md | 21 ----- content/docs/guide/advanced/cli.fr.md | 4 +- content/docs/guide/organize-files.en.md | 83 ----------------- content/docs/guide/organize-files.fr.md | 113 ----------------------- 8 files changed, 5 insertions(+), 273 deletions(-) delete mode 100755 content/docs/guide/organize-files.en.md delete mode 100755 content/docs/guide/organize-files.fr.md diff --git a/Makefile b/Makefile index a3c6794..50322a2 100644 --- a/Makefile +++ b/Makefile @@ -10,7 +10,7 @@ clean: rm -rf public resources ## Delete outputs: public & resources build: clean## Build site with production settings and put deliverables in ./public - hugo --verbose --minify --environment prod + hugo -v --minify --environment prod dev: clean ## Build site with development settings hugo server --watch --disableFastRender --printI18nWarnings diff --git a/content/docs/guide/_index.en.md b/content/docs/guide/_index.en.md index 2a56fab..06764dc 100755 --- a/content/docs/guide/_index.en.md +++ b/content/docs/guide/_index.en.md @@ -7,25 +7,10 @@ sidebar: open: true --- -Explore the following sections to learn how to use V8S: - - - -{{< cards >}} - {{< card link="organize-files" title="Organize Files" icon="document-duplicate" >}} - {{< card link="configuration" title="Configuration" icon="adjustments" >}} - {{< card link="markdown" title="Markdown" icon="markdown" >}} - {{< card link="syntax-highlighting" title="Syntax Highlighting" icon="sparkles" >}} - {{< card link="latex" title="LaTeX" icon="variable" >}} - {{< card link="diagrams" title="Diagrams" icon="chart-square-bar" >}} - {{< card link="shortcodes" title="Shortcodes" icon="template" >}} - {{< card link="deploy-site" title="Deploy Site" icon="server" >}} -{{< /cards >}} - ## Questions or Feedback? {{< cards >}} {{< card link="https://github.com/orgs/vanityURLs/discussions" title="Discussions" icon="template">}} {{< card link="https://github.com/vanityURLs/vanityURLs/issues" title="Issues" icon="server">}} -{{< /cards >}} \ No newline at end of file +{{< /cards >}} diff --git a/content/docs/guide/_index.fr.md b/content/docs/guide/_index.fr.md index 2a56fab..06764dc 100755 --- a/content/docs/guide/_index.fr.md +++ b/content/docs/guide/_index.fr.md @@ -7,25 +7,10 @@ sidebar: open: true --- -Explore the following sections to learn how to use V8S: - - - -{{< cards >}} - {{< card link="organize-files" title="Organize Files" icon="document-duplicate" >}} - {{< card link="configuration" title="Configuration" icon="adjustments" >}} - {{< card link="markdown" title="Markdown" icon="markdown" >}} - {{< card link="syntax-highlighting" title="Syntax Highlighting" icon="sparkles" >}} - {{< card link="latex" title="LaTeX" icon="variable" >}} - {{< card link="diagrams" title="Diagrams" icon="chart-square-bar" >}} - {{< card link="shortcodes" title="Shortcodes" icon="template" >}} - {{< card link="deploy-site" title="Deploy Site" icon="server" >}} -{{< /cards >}} - ## Questions or Feedback? {{< cards >}} {{< card link="https://github.com/orgs/vanityURLs/discussions" title="Discussions" icon="template">}} {{< card link="https://github.com/vanityURLs/vanityURLs/issues" title="Issues" icon="server">}} -{{< /cards >}} \ No newline at end of file +{{< /cards >}} diff --git a/content/docs/guide/advanced/_index.en.md b/content/docs/guide/advanced/_index.en.md index 0b7424c..1ea5418 100755 --- a/content/docs/guide/advanced/_index.en.md +++ b/content/docs/guide/advanced/_index.en.md @@ -5,24 +5,3 @@ prev: /docs/guide/diagrams next: /docs/guide/shortcodes/callout --- -[Hugo Shortcodes](https://gohugo.io/content-management/shortcodes/) are simple snippets inside your content files calling built-in or custom templates. - -Hextra provides a collection of beautiful shortcodes to enhance your content. - -{{< cards >}} - {{< card link="callout" title="Callout" icon="warning" >}} - {{< card link="cards" title="Cards" icon="card" >}} - {{< card link="details" title="Details" icon="chevron-right" >}} - {{< card link="filetree" title="FileTree" icon="folder-tree" >}} - {{< card link="icon" title="Icon" icon="badge-check" >}} - {{< card link="steps" title="Steps" icon="one" >}} - {{< card link="tabs" title="Tabs" icon="collection" >}} -{{< /cards >}} - -
- -Additional shortcodes provided by Hugo and Hextra: - -{{< cards >}} - {{< card link="others" title="Others" icon="view-grid" >}} -{{< /cards >}} diff --git a/content/docs/guide/advanced/_index.fr.md b/content/docs/guide/advanced/_index.fr.md index 0b7424c..1ea5418 100755 --- a/content/docs/guide/advanced/_index.fr.md +++ b/content/docs/guide/advanced/_index.fr.md @@ -5,24 +5,3 @@ prev: /docs/guide/diagrams next: /docs/guide/shortcodes/callout --- -[Hugo Shortcodes](https://gohugo.io/content-management/shortcodes/) are simple snippets inside your content files calling built-in or custom templates. - -Hextra provides a collection of beautiful shortcodes to enhance your content. - -{{< cards >}} - {{< card link="callout" title="Callout" icon="warning" >}} - {{< card link="cards" title="Cards" icon="card" >}} - {{< card link="details" title="Details" icon="chevron-right" >}} - {{< card link="filetree" title="FileTree" icon="folder-tree" >}} - {{< card link="icon" title="Icon" icon="badge-check" >}} - {{< card link="steps" title="Steps" icon="one" >}} - {{< card link="tabs" title="Tabs" icon="collection" >}} -{{< /cards >}} - -
- -Additional shortcodes provided by Hugo and Hextra: - -{{< cards >}} - {{< card link="others" title="Others" icon="view-grid" >}} -{{< /cards >}} diff --git a/content/docs/guide/advanced/cli.fr.md b/content/docs/guide/advanced/cli.fr.md index da4df0c..75fbaf8 100755 --- a/content/docs/guide/advanced/cli.fr.md +++ b/content/docs/guide/advanced/cli.fr.md @@ -1,6 +1,6 @@ --- -title: Administration -linkTitle: admin +title: Ligne de commande +linkTitle: CLI prev: /docs/install next: /docs/how --- diff --git a/content/docs/guide/organize-files.en.md b/content/docs/guide/organize-files.en.md deleted file mode 100755 index 68da41b..0000000 --- a/content/docs/guide/organize-files.en.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Organize Files -weight: 3 -prev: /docs/guide ---- - -## Directory Structure - - -{{< filetree/container >}} - {{< filetree/folder name="vanityURLS" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/file name=".gitignore" >}} - {{< filetree/file name="LICENSE" >}} - {{< filetree/file name="Makefile" >}} - {{< filetree/file name="README.md" >}} - {{< filetree/file name="vanityURLS.conf" >}} - - {{< filetree/folder name="build" state="open" >}} - {{< filetree/file name="_headers" >}} - {{< /filetree/folder >}} - {{< filetree/folder name="scripts" state="open" >}} - {{< filetree/file name="lnk" >}} - {{< filetree/file name="validateURL" >}} - {{< /filetree/folder >}} - {{< /filetree/folder >}} -{{< /filetree/container >}} - - - -{{< callout emoji="ℹ️">}} - It is recommended to keep the sidebar not too deep. If you have a lot of content, consider **splitting them into multiple sections**. -{{< /callout >}} - -Each of the `_index.md` files is the index page for the corresponding section. The other Markdown files are regular pages. - -``` -content -├── _index.md // <- / -├── docs -│ ├── _index.md // <- /docs/ -│ ├── getting-started.md // <- /docs/getting-started/ -│ └── guide -│ ├── _index.md // <- /docs/guide/ -│ └── organize-files.md // <- /docs/guide/organize-files/ -└── blog - ├── _index.md // <- /blog/ - └── post-1.md // <- /blog/post-1/ -``` - -## Layouts - -Hextra offers three layouts for different content types: - -| Layout | Directory | Features | -| :-------- | :-------------------- | :--------------------------------------------------------------- | -| `docs` | `content/docs/` | Ideal for structured documentation, same as this section. | -| `blog` | `content/blog/` | For blog postings, with both listing and detailed article views. | -| `default` | All other directories | Single-page article view without sidebar. | - -To customize a section to mirror the behavior of a built-in layout, specify the desired type in the front matter of the section's `_index.md`. - -```yaml {filename="content/my-docs/_index.md"} ---- -title: My Docs -cascade: - type: docs ---- -``` - -The above example configuration ensures that the content files inside `content/my-docs/` will be treated as documentation (`docs` type) by default. - -## Sidebar Navigation - -The sidebar navigation is generated automatically based on the content organization alphabetically. To manually configure the sidebar order, we can use the `weight` parameter in the front matter of the Markdown files. - -```yaml {filename="content/docs/guide/_index.md"} ---- -title: Guide -weight: 2 ---- -``` - diff --git a/content/docs/guide/organize-files.fr.md b/content/docs/guide/organize-files.fr.md deleted file mode 100755 index 68449e0..0000000 --- a/content/docs/guide/organize-files.fr.md +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: Organize Files -weight: 3 -prev: /docs/guide ---- - -## Directory Structure - -By default, Hugo searches 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: - - - -{{< filetree/container >}} - {{< filetree/folder name="content" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/folder name="docs" state="open" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/file name="getting-started.md" >}} - {{< filetree/folder name="guide" state="open" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/file name="organize-files.md" >}} - {{< /filetree/folder >}} - {{< /filetree/folder >}} - {{< filetree/folder name="blog" state="open" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/file name="post-1.md" >}} - {{< /filetree/folder >}} - {{< /filetree/folder >}} -{{< /filetree/container >}} - - -{{< filetree/container >}} - {{< filetree/folder name="content" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/file name=".gitignore" >}} - {{< filetree/file name="LICENSE" >}} - {{< filetree/file name="Makefile" >}} - {{< filetree/file name="README.md" >}} - {{< filetree/file name="vanityURLS.conf" >}} - {{< filetree/folder name="docs" state="open" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/file name="getting-started.md" >}} - {{< filetree/folder name="guide" state="open" >}} - {{< filetree/file name="_index.md" >}} - {{< filetree/file name="organize-files.md" >}} - {{< /filetree/folder >}} - {{< /filetree/folder >}} - {{< filetree/folder name="build" state="open" >}} - {{< filetree/file name="_headers" >}} - {{< /filetree/folder >}} - {{< filetree/folder name="scripts" state="open" >}} - {{< filetree/file name="lnk" >}} - {{< filetree/file name="validateURL" >}} - {{< /filetree/folder >}} - {{< /filetree/folder >}} -{{< /filetree/container >}} - - - -{{< callout emoji="ℹ️">}} - It is recommended to keep the sidebar not too deep. If you have a lot of content, consider **splitting them into multiple sections**. -{{< /callout >}} - -Each of the `_index.md` files is the index page for the corresponding section. The other Markdown files are regular pages. - -``` -content -├── _index.md // <- / -├── docs -│ ├── _index.md // <- /docs/ -│ ├── getting-started.md // <- /docs/getting-started/ -│ └── guide -│ ├── _index.md // <- /docs/guide/ -│ └── organize-files.md // <- /docs/guide/organize-files/ -└── blog - ├── _index.md // <- /blog/ - └── post-1.md // <- /blog/post-1/ -``` - -## Layouts - -Hextra offers three layouts for different content types: - -| Layout | Directory | Features | -| :-------- | :-------------------- | :--------------------------------------------------------------- | -| `docs` | `content/docs/` | Ideal for structured documentation, same as this section. | -| `blog` | `content/blog/` | For blog postings, with both listing and detailed article views. | -| `default` | All other directories | Single-page article view without sidebar. | - -To customize a section to mirror the behavior of a built-in layout, specify the desired type in the front matter of the section's `_index.md`. - -```yaml {filename="content/my-docs/_index.md"} ---- -title: My Docs -cascade: - type: docs ---- -``` - -The above example configuration ensures that the content files inside `content/my-docs/` will be treated as documentation (`docs` type) by default. - -## Sidebar Navigation - -The sidebar navigation is generated automatically based on the content organization alphabetically. To manually configure the sidebar order, we can use the `weight` parameter in the front matter of the Markdown files. - -```yaml {filename="content/docs/guide/_index.md"} ---- -title: Guide -weight: 2 ---- -``` -