initial commit

README.md

@@ -0,0 +1,95 @@
+# Wiki.js Blog Writer Pipeline
+
+Automated pipeline that fetches a page from a [Wiki.js](https://js.wiki) instance, turns it into a blog post using Google Gemini, translates it, and publishes it back to the wiki under `/blog/`.
+
+## How it works
+
+```
+Wiki.js page  →  SOURCE.md  →  BLOGPOST.md  →  TRANSLATED_BLOGPOST.md  →  Wiki.js /blog/
+     fetch           write          translate             upload
+```
+
+1. **fetch** — Downloads a Wiki.js page as Markdown via GraphQL
+2. **write** — Gemini reads `INSTRUCTIONS.md` and writes a blog post from `SOURCE.md` in the configured language
+3. **translate** — Gemini translates the blog post into the target language
+4. **upload** — Publishes the translated post to Wiki.js under `/blog/{kebab-case-title}`; creates the page if it doesn't exist, updates it if it does
+
+## Requirements
+
+- Python 3.8+
+- A running Wiki.js instance with API access
+- A Google Gemini API key (get one free at [aistudio.google.com](https://aistudio.google.com))
+
+## Setup
+
+**1. Clone the repo and enter the directory**
+
+```bash
+git clone <your-repo>
+cd blog_writer
+```
+
+**2. Copy the example env file and fill in your values**
+
+```bash
+cp .env.example .env
+```
+
+| Variable | Description |
+|---|---|
+| `WIKI_BASE_DOMAIN` | Base URL of your Wiki.js instance, e.g. `https://wiki.example.com` |
+| `WIKI_TOKEN` | Wiki.js API bearer token (Admin → API Access) |
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `ORIGINAL_LANG` | Language for the generated blog post (default: `Hungarian`) |
+| `TRANSLATE_LANG` | Target language for translation (default: `English`) |
+
+**3. Create an `INSTRUCTIONS.md` file**
+
+This file tells Gemini how to write the blog post — tone, structure, length, style, etc. Example:
+
+```markdown
+Write an engaging blog post aimed at a general technical audience.
+Use a friendly but professional tone. Keep it under 600 words.
+Start with a short hook, then summarize the key points, and end with a call to action.
+Do not use bullet points — write in flowing paragraphs.
+```
+
+## Usage
+
+```bash
+# Fetch a wiki page
+make fetch URL=/path/to/page
+
+# Generate the blog post
+make write
+
+# Translate it
+make translate
+
+# Upload to Wiki.js
+make upload
+
+# Run the full pipeline (write → translate → upload)
+make all
+```
+
+> `make fetch` must be run separately with a `URL` argument before `make all`.
+
+## File overview
+
+| File | Description |
+|---|---|
+| `tool.py` | Main Python script |
+| `Makefile` | Convenience wrapper around `tool.py` |
+| `.env` | Your local environment variables (never commit this) |
+| `.env.example` | Example env file safe to commit |
+| `INSTRUCTIONS.md` | Gemini prompt instructions for blog post style |
+| `SOURCE.md` | Raw Markdown fetched from Wiki.js |
+| `BLOGPOST.md` | Generated blog post in `ORIGINAL_LANG` |
+| `TRANSLATED_BLOGPOST.md` | Translated blog post in `TRANSLATE_LANG` |
+
+## Notes
+
+- The `# H1` title is extracted from `TRANSLATED_BLOGPOST.md` and used as both the Wiki.js page title and the URL slug — it is stripped from the content body to avoid duplication.
+- If a page already exists at the target path, it will be updated rather than duplicated.
+- Add `.env`, `SOURCE.md`, `BLOGPOST.md`, and `TRANSLATED_BLOGPOST.md` to your `.gitignore`.