Feature/post media translations (#42)

* chore: updated todo with translation ideas

* feat: first take at the implementation of translations

* fix: small addition for the translation feature

* feat: support language switching in the editor and preview

* feat: better handling of long bodies by not running them through a json envelope

* fix: unknown macros have better fallback

* feat: api for python to get translations

* fix: strip dumb prefix of content in translation

* feat: extend meta diff for translations

* feat: hook up translations to rebuild-from-disk

* feat: generation of the website prefers project language, falling back to canonical language

* fix: crashes during rendering

* feat: translation validation report

* fix: made the translation validation actually work

* chore: reorganization of menu

* fix: some topics cleanup

* chore: updated doc

* feat: translations for media

* feat: more aligned in UI/UX

* feat: edit translations possible

* chore: added full multi-language todo

* chore: updated todo for clarity

* feat: implementation of full multi-linguality

* fix: page creation creates pages

* fix: flags on every page

* fix: better prompt

* feat: made MCP server aware of language content

* feat: python tools for translations

* fix: better fill-in-translations

* fix: better prompt for translation. maybe.

* fix: losing posts from search due to translation process

* fix: translation validation handles in-db content and fill-in of missing translations fixed to flush

* fix: faster scanning for infilling of missing translations

* chore: updated agent instructions

* feat: calendar and tag cloud respect current language now

* fix: retries going up

* fix: got metadata-diff and rebuild into sync

* fix: extended meta-diff for timestamps

* fix: made website validation look at translated content, too

* fix: multi-lingual search

* chore: refactor Editor.tsx into two separate editors

* feat: do language detection when no explicit language given

---------

Co-authored-by: hugo <hugoms@me.com>

src/main/engine/postTranslationFileUtils.ts

@@ -0,0 +1,46 @@
+import * as fs from 'fs/promises';
+import matter from 'gray-matter';
+
+export interface PostTranslationFileData {
+  translationFor: string;
+  language: string;
+  title: string;
+  excerpt?: string;
+  content: string;
+}
+
+interface PostTranslationFileMetadata {
+  translationFor?: string;
+  language?: string;
+  title?: string;
+  excerpt?: string;
+}
+
+export async function readPostTranslationFile(filePath: string): Promise<PostTranslationFileData | null> {
+  try {
+    try {
+      await fs.access(filePath);
+    } catch {
+      return null;
+    }
+
+    const fileContent = await fs.readFile(filePath, 'utf-8');
+    const { data, content } = matter(fileContent);
+    const metadata = data as PostTranslationFileMetadata;
+
+    if (!metadata.translationFor || !metadata.language || !metadata.title) {
+      return null;
+    }
+
+    return {
+      translationFor: metadata.translationFor,
+      language: metadata.language,
+      title: metadata.title,
+      excerpt: metadata.excerpt || undefined,
+      content,
+    };
+  } catch (error) {
+    console.error(`Failed to parse post translation file: ${filePath}`, error);
+    return null;
+  }
+}