Preventing recursive directory scanning in media libraries

[asher-floyd]

Usecase: migrated a large-ish WP site to Docusaurus. Currently most image assets are dumped in one folder so I don't have major headaches when I implement i18n (which Docusaurus handles strangely, but anyway). The subfolders contain assets for very specific image-heavy non .md pages (which localise differently using a translate function in react) which I'd like for the media library to not scan and load.

So we have:

/static/img - contains 500ish loose images
        |___ /pdf - 50ish pdfs
        |___ /branding - branding assets, roughly 200 of them, with subfolders. 
        |___/.... 

For performance and usability reasons, it would be great to ignore all subfolders (which are defined in their own collections/singletons) when looking at the default media library.

Is this currently possible? Any Docusaurus maintainers able to weigh in with some advice? I'd like to clean things up at some point, but I need to feel out the workflow with Sveltia and i18n before I start moving stuff around.

[kyoshino]

We don’t have any control for it yet. The current behaviour of showing all the files recursively is actually temporary before these features are implemented.

• Feature request: Manual assets folder control #301
• Feature request: Directory navigation in media library #420

So, I can add a temporary option to disable the recursive scanning if needed.

[asher-floyd]

No worries, I'll sit tight and should really clean out the folder anyway.

On the Docusaurus i18n topic, is it possible to define different locations per-locale? The Sveltia side-by-side i18n implementation is phenomenal but Docusaurus uses ./docs as its default locale source and ./i18n/[locale]/docusaurus-plugin-content-docs/current as its locale doc base paths. Lead dev says translation co-location is on the roadmap but is proving to be a technical challenge to implement.

Thank you so much for your work on Sveltia so far ❤️

[asher-floyd]

Actually, never mind on the per-locale settings. I've written a script which runs before docusaurus build and makes use of structure: multiple_files instead, so Sveltia points at the file and makes hello.mdx hello.es.mdx hello.fr.mdx etc.

Putting it here for the sake of anybody Googling.

#!/bin/bash

# Define source directory
SRC_DIR="docs"

# Function to copy translation files for a specific language
copy_translation_files() {
    local lang_code=$1
    local file_pattern="*.$lang_code.mdx"
    local dest_dir="i18n/$lang_code/docusaurus-plugin-content-docs/current"
    
    echo "Processing $lang_code translations..."
    
    # Create destination directory if it doesn't exist
    mkdir -p "$dest_dir"
    
    # Create a temporary file to track processed files
    temp_file=$(mktemp)
    
    # Find all *.[lang_code].mdx files in the docs directory
    find "$SRC_DIR" -type f -name "$file_pattern" | while read -r file; do
        # Get the relative path from the source directory
        rel_path="${file#$SRC_DIR/}"
        
        # Create the directory structure in the destination
        dest_file_dir="$dest_dir/$(dirname "$rel_path")"
        mkdir -p "$dest_file_dir"
        
        # Get the filename without the language code part
        filename=$(basename "$file")
        new_filename="${filename/.$lang_code.mdx/.mdx}"
        
        # Full path to the destination file
        dest_file="$dest_file_dir/$new_filename"
        
        # Add this file to our tracking list
        echo "$dest_file" >> "$temp_file"
        
        # Copy the file with the new name
        cp "$file" "$dest_file"
        
        echo "Copied: $file -> $dest_file"
    done
    
    # Find and remove files in the destination that don't exist in the source
    echo "Checking for files to remove..."
    find "$dest_dir" -type f -name "*.mdx" | while read -r dest_file; do
        if ! grep -q "^$dest_file$" "$temp_file"; then
            echo "Removing: $dest_file (no longer exists in source)"
            rm "$dest_file"
        fi
    done
    
    # Clean up the temporary file
    rm "$temp_file"
    
    # Remove empty directories
    find "$dest_dir" -type d -empty -delete
    
    echo "$lang_code translation files copying complete!"
    echo "----------------------------------------"
}

# Copy French translations
copy_translation_files "fr"

# Copy Spanish translations
copy_translation_files "es"

echo "All translation files have been processed successfully!"

Add this to docusaurus.config.ts or there will be issues

          exclude: [
            '**/*.es.{js,jsx,ts,tsx,md,mdx}',
            '**/*.fr.{js,jsx,ts,tsx,md,mdx}',
          ],