Blogging with Gleam, Org-Mode and Pandoc

I’ve stumbled across a method of composing programs that excites me very much. In fact, my enthusiasm is so great that I must warn the reader to discount much of what I shall say as the ravings of a fanatic who thinks he has just seen a great light. (Knuth 1984, 1)

Welcome to the first Byzantine Systems blog post. This is not my first attempt at building a website around Org-mode. I have already written about the road to Emacs maximalism in my own personal blog, where Emacs, a few questionable scripts and Nix held everything together. This time I wanted to keep the part that worked (writing everything in Emacs) while making the publishing side smaller, typed and easier to understand.

The end experiment uses Orgmode as source, Emacs as writing environment, d2 for diagrams, Pandoc as converter, Nix for build environment, and Gleam with Blogatto for a typed static-site pipeline. The post index is just a Gleam function returning a Lustre element. I only interact with the Org documents. Nix is the glue that makes the rest of the pipeline pleasantly uneventful.

Why keep everything inside Emacs? My close friend Marcos Magueta made a video arguing about BLOAT. Emacs, from a UNIX perspective, is pure bloat, but it can be good bloat. Consistency requires a central body that promulgates standards, like Apple for Macintosh. No such body exists for Unix utilities.

لقد عثرت على طريقة لتأليف البرامج تثيرني كثيرًا. في الواقع، حماسي كبير لدرجة أنني يجب أن أحذر القارئ من خصم الكثير مما سأقوله باعتباره هذيان متعصب يعتقد أنه رأى للتو نورًا عظيمًا. (Knuth 1984, 1)

مرحبًا بك في أول مشاركة في مدونة Byzantine Systems. ليست هذه أول محاولة لي لبناء موقع ويب حول Org-mode. لقد كتبت بالفعل عن الطريق إلى التطرف في Emacs في مدونتي الشخصية، حيث كان Emacs وبعض البرامج النصية المشكوك فيها وNix يحملون كل شيء معًا. هذه المرة أردت الاحتفاظ بالجزء الذي نجح (كتابة كل شيء في Emacs) مع جعل جانب النشر أصغر ومكتوبًا وأسهل في الفهم.

تستخدم التجربة النهائية Orgmode كمصدر، وEmacs كبيئة كتابة، وd2 للرسوم البيانية، وPandoc كمحول، وNix لبيئة البناء، وGleam مع Blogatto لخط أنابيب موقع ثابت مكتوب. فهرس المشاركات هو مجرد دالة Gleam تُرجع عنصر Lustre. أنا أتفاعل فقط مع مستندات Org. Nix هو الغراء الذي يجعل بقية خط الأنابيب هادئًا بشكل ممتع.

لماذا نحتفظ بكل شيء داخل Emacs؟ صديقي المقرب Marcos Magueta صنع فيديو يتجادل حول BLOAT. من منظور UNIX، Emacs هو تضخم خالص، لكنه يمكن أن يكون تضخمًا جيدًا. يتطلب الاتساق هيئة مركزية تصدر معايير، مثل Apple لـ Macintosh. لا توجد مثل هذه الهيئة لأدوات Unix.

আমি প্রোগ্রাম রচনার একটি পদ্ধতি খুঁজে পেয়েছি যা আমাকে খুব উত্তেজিত করে। আসলে, আমার উৎসাহ এতটাই মহান যে আমাকে পাঠককে সতর্ক করতে হবে যে আমি যা বলব তার বেশিরভাগই একজন ধর্মান্ধের প্রলাপ হিসাবে ছাড় দেওয়া উচিত যে মনে করে সে সবেমাত্র একটি মহান আলো দেখেছে। (Knuth 1984, 1)

Byzantine Systems-এর প্রথম ব্লগ পোস্টে স্বাগতম। এটি Org-mode-এর চারপাশে একটি ওয়েবসাইট তৈরির আমার প্রথম প্রচেষ্টা নয়। আমি ইতিমধ্যে আমার নিজের ব্যক্তিগত ব্লগে Emacs সর্বাধিকতাবাদের পথ সম্পর্কে লিখেছি, যেখানে Emacs, কিছু সন্দেহজনক স্ক্রিপ্ট এবং Nix সবকিছু একসাথে ধরে রেখেছিল। এইবার আমি সেই অংশটি রাখতে চেয়েছিলাম যা কাজ করেছিল (Emacs-এ সবকিছু লেখা) যখন প্রকাশনার দিকটি ছোট, টাইপ করা এবং বোঝা সহজ করে তুলেছিলাম।

চূড়ান্ত পরীক্ষাটি Orgmode-কে উৎস হিসাবে, Emacs-কে লেখার পরিবেশ হিসাবে, d2-কে ডায়াগ্রামের জন্য, Pandoc-কে রূপান্তরকারী হিসাবে, Nix-কে বিল্ড পরিবেশের জন্য এবং Gleam-কে Blogatto-এর সাথে একটি টাইপ করা স্ট্যাটিক-সাইট পাইপলাইনের জন্য ব্যবহার করে। পোস্ট সূচকটি কেবল একটি Gleam ফাংশন যা একটি Lustre উপাদান ফেরত দেয়। আমি কেবল Org নথিগুলির সাথে যোগাযোগ করি। Nix হল আঠা যা পাইপলাইনের বাকি অংশকে আনন্দদায়কভাবে নীরব করে তোলে।

কেন সবকিছু Emacs-এর ভিতরে রাখবেন? আমার ঘনিষ্ঠ বন্ধু Marcos Magueta BLOAT সম্পর্কে তর্ক করে একটি ভিডিও তৈরি করেছেন। UNIX দৃষ্টিকোণ থেকে, Emacs হল খাঁটি ব্লোট, তবে এটি ভাল ব্লোট হতে পারে। ধারাবাহিকতার জন্য একটি কেন্দ্রীয় সংস্থার প্রয়োজন যা মান প্রচার করে, যেমন Apple Macintosh-এর জন্য। Unix ইউটিলিটিগুলির জন্য এমন কোনও সংস্থা নেই।

Ich bin auf eine Methode zum Komponieren von Programmen gestoßen, die mich sehr begeistert. Tatsächlich ist meine Begeisterung so groß, dass ich den Leser warnen muss, einen Großteil dessen, was ich sagen werde, als das Geschwafel eines Fanatikers abzutun, der glaubt, gerade ein großes Licht gesehen zu haben. (Knuth 1984, 1)

Willkommen zum ersten Blogbeitrag von Byzantine Systems. Dies ist nicht mein erster Versuch, eine Website rund um Org-mode aufzubauen. Ich habe bereits über den Weg zum Emacs-Maximalismus in meinem eigenen persönlichen Blog geschrieben, wo Emacs, ein paar fragwürdige Skripte und Nix alles zusammenhielten. Diesmal wollte ich den Teil behalten, der funktionierte (alles in Emacs zu schreiben), während ich die Veröffentlichungsseite kleiner, typisiert und leichter verständlich machte.

Das endgültige Experiment verwendet Orgmode als Quelle, Emacs als Schreibumgebung, d2 für Diagramme, Pandoc als Konverter, Nix für die Build-Umgebung und Gleam mit Blogatto für eine typisierte statische Site-Pipeline. Der Beitragsindex ist nur eine Gleam-Funktion, die ein Lustre-Element zurückgibt. Ich interagiere nur mit den Org-Dokumenten. Nix ist der Klebstoff, der den Rest der Pipeline angenehm ereignislos macht.

Warum alles in Emacs behalten? Mein enger Freund Marcos Magueta hat ein Video gemacht, das über BLOAT diskutiert. Aus UNIX-Perspektive ist Emacs reiner Bloat, aber es kann guter Bloat sein. Konsistenz erfordert eine zentrale Stelle, die Standards verkündet, wie Apple für Macintosh. Eine solche Stelle existiert für Unix-Dienstprogramme nicht.

He tropezado con un método de componer programas que me entusiasma mucho. De hecho, mi entusiasmo es tan grande que debo advertir al lector que descuente gran parte de lo que diré como los desvaríos de un fanático que cree haber visto una gran luz. (Knuth 1984, 1)

Bienvenido a la primera publicación del blog Byzantine Systems. Este no es mi primer intento de construir un sitio web alrededor de Org-mode. Ya he escrito sobre el camino hacia el maximalismo de Emacs en mi propio blog personal, donde Emacs, algunos scripts cuestionables y Nix mantenían todo unido. Esta vez quería mantener la parte que funcionaba (escribir todo en Emacs) mientras hacía el lado de publicación más pequeño, tipado y fácil de entender.

El experimento final usa Orgmode como fuente, Emacs como entorno de escritura, d2 para diagramas, Pandoc como convertidor, Nix para el entorno de construcción, y Gleam con Blogatto para un pipeline de sitio estático tipado. El índice de publicaciones es solo una función de Gleam que devuelve un elemento de Lustre. Solo interactúo con los documentos Org. Nix es el pegamento que hace que el resto del pipeline sea agradablemente tranquilo.

¿Por qué mantener todo dentro de Emacs? Mi amigo cercano Marcos Magueta hizo un video discutiendo sobre BLOAT. Desde una perspectiva UNIX, Emacs es pura hinchazón, pero puede ser buena hinchazón. La consistencia requiere un cuerpo central que promulgue estándares, como Apple para Macintosh. No existe tal cuerpo para las utilidades Unix.

J'ai découvert une méthode de composition de programmes qui m'excite beaucoup. En fait, mon enthousiasme est si grand que je dois avertir le lecteur de ne pas tenir compte d'une grande partie de ce que je dirai comme les divagations d'un fanatique qui pense avoir vu une grande lumière. (Knuth 1984, 1)

Bienvenue dans le premier article de blog Byzantine Systems. Ce n'est pas ma première tentative de construire un site Web autour d'Org-mode. J'ai déjà écrit sur le chemin vers le maximalisme d'Emacs dans mon propre blog personnel, où Emacs, quelques scripts douteux et Nix maintenaient tout ensemble. Cette fois, je voulais garder la partie qui fonctionnait (écrire tout dans Emacs) tout en rendant le côté publication plus petit, typé et plus facile à comprendre.

L'expérience finale utilise Orgmode comme source, Emacs comme environnement d'écriture, d2 pour les diagrammes, Pandoc comme convertisseur, Nix pour l'environnement de construction, et Gleam avec Blogatto pour un pipeline de site statique typé. L'index des articles est juste une fonction Gleam retournant un élément Lustre. Je n'interagis qu'avec les documents Org. Nix est la colle qui rend le reste du pipeline agréablement sans événement.

Pourquoi tout garder dans Emacs ? Mon ami proche Marcos Magueta a fait une vidéo discutant de BLOAT. D'un point de vue UNIX, Emacs est un pur bloat, mais cela peut être un bon bloat. La cohérence nécessite un organisme central qui promulgue des normes, comme Apple pour Macintosh. Aucun tel organisme n'existe pour les utilitaires Unix.

मैं प्रोग्राम बनाने की एक ऐसी विधि पर ठोकर खाई है जो मुझे बहुत उत्साहित करती है। वास्तव में, मेरा उत्साह इतना महान है कि मुझे पाठक को चेतावनी देनी चाहिए कि मैं जो कुछ भी कहूँगा उसका अधिकांश भाग एक कट्टरपंथी की बड़बड़ाहट के रूप में छूट दें जो सोचता है कि उसने अभी एक महान प्रकाश देखा है। (Knuth 1984, 1)

Byzantine Systems के पहले ब्लॉग पोस्ट में आपका स्वागत है। यह Org-mode के आसपास वेबसाइट बनाने का मेरा पहला प्रयास नहीं है। मैंने पहले ही अपने व्यक्तिगत ब्लॉग में Emacs अधिकतमवाद के मार्ग के बारे में लिखा है, जहाँ Emacs, कुछ संदिग्ध स्क्रिप्ट और Nix ने सब कुछ एक साथ रखा था। इस बार मैं उस हिस्से को रखना चाहता था जो काम करता था (Emacs में सब कुछ लिखना) जबकि प्रकाशन पक्ष को छोटा, टाइप किया हुआ और समझने में आसान बनाना चाहता था।

अंतिम प्रयोग Orgmode को स्रोत के रूप में, Emacs को लेखन वातावरण के रूप में, d2 को आरेखों के लिए, Pandoc को कनवर्टर के रूप में, Nix को निर्माण वातावरण के लिए, और Gleam को Blogatto के साथ एक टाइप किए गए स्थिर-साइट पाइपलाइन के लिए उपयोग करता है। पोस्ट इंडेक्स सिर्फ एक Gleam फ़ंक्शन है जो Lustre तत्व लौटाता है। मैं केवल Org दस्तावेज़ों के साथ बातचीत करता हूँ। Nix वह गोंद है जो पाइपलाइन के बाकी हिस्से को सुखद रूप से अविचलित बनाता है।

सब कुछ Emacs के अंदर क्यों रखें? मेरे करीबी दोस्त Marcos Magueta ने BLOAT के बारे में बहस करते हुए एक वीडियो बनाया। UNIX दृष्टिकोण से, Emacs शुद्ध ब्लोट है, लेकिन यह अच्छा ब्लोट हो सकता है। स्थिरता के लिए एक केंद्रीय निकाय की आवश्यकता होती है जो मानकों को प्रख्यापित करता है, जैसे Apple Macintosh के लिए। Unix उपयोगिताओं के लिए ऐसा कोई निकाय मौजूद नहीं है।

Saya menemukan metode menyusun program yang sangat membuat saya bersemangat. Faktanya, antusiasme saya begitu besar sehingga saya harus memperingatkan pembaca untuk mengabaikan sebagian besar dari apa yang saya katakan sebagai ocehan seorang fanatik yang mengira baru saja melihat cahaya besar. (Knuth 1984, 1)

Selamat datang di posting blog pertama Byzantine Systems. Ini bukan percobaan pertama saya membangun situs web di sekitar Org-mode. Saya sudah menulis tentang jalan menuju maksimalisme Emacs di blog pribadi saya, di mana Emacs, beberapa skrip yang dipertanyakan, dan Nix menyatukan semuanya. Kali ini saya ingin mempertahankan bagian yang berhasil (menulis semuanya di Emacs) sambil membuat sisi penerbitan lebih kecil, bertipe, dan lebih mudah dipahami.

Eksperimen akhir menggunakan Orgmode sebagai sumber, Emacs sebagai lingkungan menulis, d2 untuk diagram, Pandoc sebagai konverter, Nix untuk lingkungan build, dan Gleam dengan Blogatto untuk pipeline situs statis yang bertipe. Indeks posting hanyalah fungsi Gleam yang mengembalikan elemen Lustre. Saya hanya berinteraksi dengan dokumen Org. Nix adalah lem yang membuat sisa pipeline menjadi tenang dengan menyenangkan.

Mengapa menyimpan semuanya di dalam Emacs? Teman dekat saya Marcos Magueta membuat video yang membahas tentang BLOAT. Dari perspektif UNIX, Emacs adalah bloat murni, tetapi bisa menjadi bloat yang baik. Konsistensi membutuhkan badan pusat yang mengumumkan standar, seperti Apple untuk Macintosh. Tidak ada badan seperti itu untuk utilitas Unix.

私はプログラムを構成する方法に出くわしましたが、それは私を非常に興奮させます。実際、私の熱意は非常に大きいので、読者に私が言うことの多くを、ちょうど偉大な光を見たと思っている狂信者の暴言として割り引くように警告しなければなりません。(Knuth 1984, 1)

Byzantine Systemsの最初のブログ投稿へようこそ。これはOrg-modeを中心にウェブサイトを構築する私の最初の試みではありません。私はすでに自分の個人的なブログでEmacsマキシマリズムへの道について書きました。そこではEmacs、いくつかの疑わしいスクリプト、Nixがすべてをまとめていました。今回は、機能していた部分（すべてをEmacsで書くこと）を維持しながら、公開側をより小さく、型付けされ、理解しやすくしたいと思いました。

最終的な実験では、Orgmodeをソースとして、Emacsを執筆環境として、d2を図用に、Pandocをコンバーターとして、Nixをビルド環境として、GleamとBlogattoを型付けされた静的サイトパイプラインとして使用します。投稿インデックスは、Lustre要素を返す単なるGleam関数です。私はOrgドキュメントとのみ対話します。Nixは、パイプラインの残りを快適に平穏にする接着剤です。

なぜすべてをEmacsの中に保つのか？私の親しい友人Marcos MaguetaがBLOATについて議論するビデオを作りました。UNIXの観点から見ると、Emacsは純粋なブロートですが、それは良いブロートになり得ます。一貫性には、AppleがMacintoshに対して行ったように、標準を公布する中央機関が必要です。Unixユーティリティにはそのような機関は存在しません。

Eu tropecei em um método de compor programas que me excita muito. Na verdade, meu entusiasmo é tão grande que devo avisar o leitor para descontar muito do que direi como os delírios de um fanático que pensa que acabou de ver uma grande luz. (Knuth 1984, 1)

Bem-vindo ao primeiro post do blog Byzantine Systems. Esta não é minha primeira tentativa de construir um site em torno do Org-mode. Já escrevi sobre o caminho para o maximalismo do Emacs no meu próprio blog pessoal, onde Emacs, alguns scripts questionáveis e Nix mantinham tudo junto. Desta vez, queria manter a parte que funcionava (escrever tudo no Emacs) enquanto tornava o lado da publicação menor, tipado e mais fácil de entender.

O experimento final usa Orgmode como fonte, Emacs como ambiente de escrita, d2 para diagramas, Pandoc como conversor, Nix para ambiente de build, e Gleam com Blogatto para um pipeline de site estático tipado. O índice de posts é apenas uma função Gleam que retorna um elemento Lustre. Eu só interajo com os documentos Org. Nix é a cola que torna o resto do pipeline agradavelmente tranquilo.

Por que manter tudo dentro do Emacs? Meu amigo próximo Marcos Magueta fez um vídeo discutindo sobre BLOAT. De uma perspectiva UNIX, Emacs é puro inchaço, mas pode ser um bom inchaço. Consistência requer um corpo central que promulgue padrões, como a Apple para o Macintosh. Não existe tal corpo para utilitários Unix.

Я наткнулся на метод составления программ, который меня очень волнует. На самом деле, мой энтузиазм настолько велик, что я должен предупредить читателя, чтобы он сбрасывал со счетов большую часть того, что я скажу, как бред фанатика, который думает, что только что увидел великий свет. (Knuth 1984, 1)

Добро пожаловать в первый пост блога Byzantine Systems. Это не моя первая попытка создать веб-сайт на основе Org-mode. Я уже писал о пути к максимализму Emacs в своем личном блоге, где Emacs, несколько сомнительных скриптов и Nix держали все вместе. На этот раз я хотел сохранить ту часть, которая работала (писать все в Emacs), сделав сторону публикации меньше, типизированной и более понятной.

Финальный эксперимент использует Orgmode как источник, Emacs как среду написания, d2 для диаграмм, Pandoc как конвертер, Nix для среды сборки, и Gleam с Blogatto для типизированного конвейера статического сайта. Индекс постов — это просто функция Gleam, возвращающая элемент Lustre. Я взаимодействую только с документами Org. Nix — это клей, который делает остальную часть конвейера приятно спокойной.

Почему все держать внутри Emacs? Мой близкий друг Marcos Magueta сделал видео, обсуждая BLOAT. С точки зрения UNIX, Emacs — это чистый блот, но это может быть хороший блот. Согласованность требует центрального органа, который promulgates стандарты, как Apple для Macintosh. Такого органа для утилит Unix не существует.

我偶然发现了一种让我非常兴奋的编程方法。事实上，我的热情如此之高，以至于我必须警告读者，要对我所说的大部分内容打折扣，因为这是一个自以为看到了伟大光明的狂热者的胡言乱语。(Knuth 1984, 1)

欢迎来到Byzantine Systems的第一篇博客文章。这不是我第一次尝试围绕Org-mode构建网站。我已经在我自己的个人博客上写过关于Emacs极致主义的道路，在那里Emacs、一些可疑的脚本和Nix把所有东西都联系在一起。这次我想保留有效的部分（在Emacs中写所有东西），同时让发布端更小、类型化且更容易理解。

最终的实验使用Orgmode作为源，Emacs作为写作环境，d2用于图表，Pandoc作为转换器，Nix用于构建环境，以及Gleam和Blogatto用于类型化的静态站点管道。帖子索引只是一个返回Lustre元素的Gleam函数。我只与Org文档交互。Nix是让管道其余部分愉快地平静的粘合剂。

为什么把所有东西都留在Emacs里？我的密友Marcos Magueta制作了一个视频，讨论BLOAT。从UNIX的角度来看，Emacs是纯粹的臃肿，但它可以是好的臃肿。一致性需要一个中央机构来颁布标准，就像Apple对Macintosh所做的那样。Unix工具不存在这样的机构。