attachments: fix incorrect links for defaultContentLanguageInSubdir=true #425

exampleSite/config.toml

@@ -124,7 +124,7 @@ disableHugoGeneratorInject = true
 
   [Languages.pir]
     title = "Cap'n Hugo Relearrrn Theme"
-    weight = 1
+    weight = 2
     languageName = "Arrr! ☠ Pirrrates ☠"
     landingPageName = "<i class='fas fa-home'></i> Arrr! Home"
 

exampleSite/content/basics/migration/_index.en.md

@@ -14,7 +14,13 @@ This document shows you what's new in the latest release. For a detailed list of
 
 ---
 
-## 5.9.0 (not yet released)
+## 5.9.0 (2022-12-23)
+
+- {{% badge style="note" title=" " %}}Change{{% /badge %}} The required folder name for the [`attachments` shortcode]({{% relref "shortcodes/attachments" %}}) was changed for leaf bundles.
+
+  Previously, the attachments for leaf bundles in non-multilang setups were required to be in a `files` subdirectory. For page bundles and leaf bundles in multilang setups they were always required to be in a `_index.<LANGCODE>.files` or `index.<LANGCODE>.files` subdirectory accordingly.
+
+  This added unnessessary complexity. So attachments for leaf bundles in non-multilang setups can now also reside in a `index.files` directory. Although the old `files` directory is now deprecated, if both directories are present, only the old `files` directory will be used for compatiblity.
 
 - {{% badge style="note" title=" " %}}Change{{% /badge %}} Absolute links prefixed with `http://` or `https://` are now opened in a separate browser tab.
 

exampleSite/content/shortcodes/attachments.en.md

@@ -31,11 +31,9 @@ While the examples are using shortcodes with named parameter you are free to als
 {{% /tab %}}
 {{< /tabs >}}
 
-The shortcode lists files found in a specific folder.
+The shortcode lists files found in a specific folder. The name of the folder depends on your page type (either branch bundle, leaf bundle or page).
 
-Currently, it supports two implementations for pages
-
-1. If your page is a Markdown file, attachments must be placed in a folder named like your page and ending with `.files`.
+1. For simple pages, attachments must be placed in a folder named like your page and ending with `.files`.
 
     > * content
     >   * _index.md
@@ -43,17 +41,39 @@ Currently, it supports two implementations for pages
     >      * attachment.pdf
     >   * page.md
 
-2. If your page is a folder, attachments must be placed in a nested `files` folder.
+2. If your page is a branch or leaf bundle, attachments must be placed in a nested `_index.files` or 'index.files' folder, accordingly.
+
+    For branch bundles:
 
     > * content
     >   * _index.md
     >   * page
     >      * index.md
-    >      * **files**
+    >      * **index.files**
     >          * attachment.pdf
 
-Be aware that if you use a multilingual website, you will need to have as many folders as languages.
+    For leaf bundles:
 
+    > * content
+    >   * _index.md
+    >   * page
+    >      * _index.md
+    >      * **_index.files**
+    >          * attachment.pdf
+
+Be aware that if you use a multilingual website, you will need to have as many folders as languages and the language code must be part of the folder name.
+
+Eg. for a site in English and Piratish:
+
+  > * content
+  >   * _index.en.md
+  >   * _index.pir.md
+  >   * **page.en.files**
+  >      * attachment.pdf
+  >   * **page.pir.files**
+  >      * attachment.pdf
+  >   * page.en.md
+  >   * page.pir.md
 
 ### Parameter
 

exampleSite/content/tests/attach/_index.en.md

@@ -0,0 +1,8 @@
++++
+description = "Testing Attachments Shortcode"
+title = "Attachments Shortcode Test"
++++
+
+Our attachment shortcode is a source of pleasure...
+
+{{%children containerstyle="div" style="h2" description="true" %}}

exampleSite/content/tests/attach/_index.pir.md

@@ -0,0 +1,5 @@
++++
+description = "Test'n Attachments Shorrrtcode"
+title = "Attachments Shorrrtcode Test"
++++
+{{< piratify >}}

exampleSite/content/tests/attach/attach1/_index.en.files/hugo.txt

@@ -0,0 +1 @@
+This is a small text

exampleSite/content/tests/attach/attach1/_index.en.md

@@ -0,0 +1,5 @@
++++
+title = "Attachments Branch Test"
++++
+
+{{% attachments /%}}

exampleSite/content/tests/attach/attach1/_index.pir.files/NoTreasure.txt

@@ -0,0 +1 @@
+Harrr, nothn' to see herre

exampleSite/content/tests/attach/attach1/_index.pir.md

@@ -0,0 +1,5 @@
++++
+title = "Attachments Brrranch Test"
++++
+
+{{% attachments /%}}

exampleSite/content/tests/attach/attach2/index.en.files/hugo.txt

@@ -0,0 +1 @@
+This is a small text

exampleSite/content/tests/attach/attach2/index.en.md

@@ -0,0 +1,5 @@
++++
+title = "Attachments Leaf Test"
++++
+
+{{% attachments /%}}

exampleSite/content/tests/attach/attach2/index.pir.files/NoTreasure.txt

@@ -0,0 +1 @@
+Harrr, nothn' to see herre

exampleSite/content/tests/attach/attach2/index.pir.md

@@ -0,0 +1,5 @@
++++
+title = "Attachments Leaf Test"
++++
+
+{{% attachments /%}}

exampleSite/content/tests/attach/attach3.en.files/hugo.txt

@@ -0,0 +1 @@
+This is a small text

exampleSite/content/tests/attach/attach3.en.md

@@ -0,0 +1,5 @@
++++
+title = "Attachments Page Test"
++++
+
+{{% attachments /%}}

exampleSite/content/tests/attach/attach3.pir.files/NoTreasure.txt

@@ -0,0 +1 @@
+Harrr, nothn' to see herre

exampleSite/content/tests/attach/attach3.pir.md

@@ -0,0 +1,5 @@
++++
+title = "Attachments Page Test"
++++
+
+{{% attachments /%}}

layouts/partials/shortcodes/attachments.html

@@ -17,19 +17,25 @@
 {{- end }}
 {{- $sort := .sort | default "asc" }}
 {{- $pattern := .pattern | default "" }}
+{{- $defaultLanguage := (index $context.Site.Home.AllTranslations 0).Lang }}
+{{- $defaultLanguagePage := index (where $context.Page.AllTranslations "Language.Lang" $defaultLanguage) 0 }}
+{{- $defaultUrlPrefix := strings.TrimRight "/" $defaultLanguagePage.RelPermalink }}
+{{- $urlPrefix := strings.TrimRight "/" $context.Page.RelPermalink }}
 {{- with $context }}
 <div class="box attachments cstyle {{ $style }}">
   <div class="box-label">{{ if $icon }}<i class="{{ $icon }}"></i>{{ end }}{{ if and $icon $title }} {{ end }}{{ $title }}</div>
   <ul class="box-content attachments-files">
-  {{- $filesName := "files" }}
-  {{- if ne .Page.File.BaseFileName "index" }}
-    {{- $filesName = printf "%s.files" .Page.File.BaseFileName }}
-  {{- end }}
   {{- $fileLink := printf "%s/%s" (.Page.Language.ContentDir | default "content") .Page.File.Dir }}
   {{- $fileLink = replace (replace $fileLink "\\" "/") "content/" "" }}
   {{- $fileDir := printf "%s/%s" (.Page.Language.ContentDir | default "content") .Page.File.Dir  }}
   {{- $fileDir = replace $fileDir "\\" "/" }}
-  {{- range sort (readDir (printf "%s%s" $fileDir $filesName) ) "Name" $sort }}
+  {{- $filesName := printf "%s.files" .Page.File.BaseFileName }}
+  {{- if and (eq .Page.File.BaseFileName "index") (fileExists (printf "%sfiles" $fileDir)) }}
+    {{- $c := "" }}{{/* backward compat to < 5.9.0 behavior */}}
+    {{- $filesName = "files" }}
+  {{- end }}
+  {{- $dir := printf "%s%s" $fileDir $filesName }}
+  {{- range sort (readDir $dir) "Name" $sort }}
     {{- if findRE $pattern .Name}}
       {{- $size := .Size }}
       {{- $unit := "Byte-symbol" }}
@@ -42,7 +48,10 @@
         {{- $unit = "Megabyte-symbol" }}
       {{- end }}
       {{- $unitsymbol := $unit | T }}
-    <li><a href="{{ (printf "%s%s/%s" $fileLink $filesName .Name) | relURL }}">{{.Name}}</a> ({{$size}} {{$unitsymbol}})</li>
+      {{- $link := (printf "%s%s/%s" $fileLink $filesName .Name) | relLangURL }}
+      {{- $c := "" }}{{/* Hugo stores the attachments always in the default language subdirectory */}}
+      {{- $link = replace $link $urlPrefix $defaultUrlPrefix 1 }}
+    <li><a href="{{ $link }}">{{.Name}}</a> ({{$size}} {{$unitsymbol}})</li>
     {{- end }}
   {{- end }}
   </ul>