Add menu entry for word cloud files generation

Author: postb99

README.md

@@ -34,6 +34,17 @@ This also helps perform statistical computations using an in-memory XML document
 - Line chart, rather than bar chart, for metrics over Seasons.
 - More advanced charts (e.g., bubble charts) to show relationships between variables, such as poem length/metric, associated categories, or category/metric associations.
 
+### Generation of word cloud text files
+
+When a poem contains a month name in its tags, I generate a word cloud text file (archived in poetry site at `content\fr\other-perspectives\les-mois\[month name]`) then use it on the following website:
+https://nuagedemots.co/
+- Remove some irrelevant terms
+- Use rectangular form
+- Use Roboto font
+- Use blue theme
+
+Then I cut out the figure to have fewer space around content. And I save it as `featured.png` in `content\fr\other-perspectives\les-mois\[month name]`.
+
 ### Content quality check
 
 Because CMS editor gives indications (fields descriptions) but a miss or typo can happen.

src/Tests/Generators/WordCloudGeneratorTest.cs

@@ -0,0 +1,14 @@
+using Toolbox.Generators;
+using Xunit;
+
+namespace Tests.Generators;
+
+public class WordCloudTextGeneratorTest(WithRealDataFixture fixture): IClassFixture<WithRealDataFixture>
+{
+  [Fact]
+  [Trait("UnitTest", "FileGeneration")]
+  public void ShouldGenerateWordCloudFiles()
+  {
+    new WordCloudTextGenerator(fixture.Configuration).GenerateWordCloudFiles(fixture.Data);
+  }  
+}

src/Tests/Generators/WordCloudTextGeneratorTest.cs

@@ -0,0 +1,31 @@
+using Microsoft.Extensions.Configuration;
+using Toolbox.Domain;
+using Toolbox.Settings;
+
+namespace Toolbox.Generators;
+
+public class WordCloudTextGenerator(IConfiguration configuration)
+{
+    private static List<string> _months =
+    [
+        "janvier", "février", "mars", "avril", "mai", "juin", "juillet", "août", "septembre", "octobre", "novembre",
+        "décembre"
+    ];
+
+    public void GenerateWordCloudFiles(Root data)
+    {
+        foreach (var month in _months)
+        {
+            var rootDir = Path.Combine(configuration[Constants.CONTENT_ROOT_DIR]!, "..", "other-perspectives",
+                "les-mois", month);
+            var filePath = Path.Combine(rootDir, "wordcloud.txt");
+            var poems = data.Seasons.SelectMany(x => x.Poems).Where(p => p.ExtraTags.Contains(month));
+            File.WriteAllText(filePath, string.Empty);
+            foreach (var poem in poems)
+            {
+                File.AppendAllText(filePath, poem.Description.ToLowerInvariant());
+                File.AppendAllText(filePath, Environment.NewLine);
+            }
+        }
+    }
+}

src/Toolbox/Generators/WordCloudTextGenerator.cs

@@ -253,6 +253,9 @@ private static async Task<bool> PerformActionAsync(MenuItem menuChoice)
                     Console.WriteLine(reusedTitle);
                 }
 
+                break;
+            case MainMenuSettings.MenuChoices.GenerateWordCloudTextFiles:
+                new WordCloudTextGenerator(_configuration!).GenerateWordCloudFiles(_data);
                 break;
             case MainMenuSettings.MenuChoices.ExitProgram:
                 Console.WriteLine("Closing program...");

src/Toolbox/Program.cs

@@ -36,6 +36,7 @@ public enum MenuChoices
         ImportEnPoems = 600,
         OutputSeasonsDuration = 700,
         OutputReusedTitles = 800,
+        GenerateWordCloudTextFiles = 900,
         ExitProgram = 99
     }
 

src/Toolbox/Settings/MainMenuSettings.cs

@@ -145,6 +145,10 @@
         "Key": 800,
         "Label": "Output reused titles"
       },
+      {
+        "Key": 900,
+        "Label": "Generate word cloud text files"
+      },
       {
         "Key": 0,
         "Label": "Reload data file"