sendok 0.1.0__tar.gz

sendok-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: sendok
+Version: 0.1.0
+Summary: Scaffolding Engine for Nimble Documentation Organizer Kit: Generator folder dokumentasi proyek yang simpel dan cepat.
+Author-email: Hasan Askari <marhaendev@gmail.com>
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Requires-Dist: click
+Requires-Dist: prompt-toolkit
+Requires-Dist: questionary
+Requires-Dist: rich
+Description-Content-Type: text/markdown
+
+# sendok 🥄
+
+**sendok** (Scaffolding Engine for Nimble Documentation Organizer Kit) is a simple and fast development tool to manage project documentation and speed up your terminal workflow.
+
+[🇮🇩 Bahasa Indonesia](README_id.md) | [🇪🇸 Español](README_es.md) | [🇯🇵 日本語](README_ja.md) | [🇨🇳 中文](README_zh.md)
+
+---
+
+## ✨ Key Features
+
+- **🚀 Instant Documentation**: Initialize `docs/` folder with standard templates (SSH, Git, Node, NVM, Angular, GitHub CLI).
+- **🌐 Multi-language Support**: Templates available in 5 languages (EN, ID, ES, JA, ZH).
+- **🍴 Git Helper (gg)**: Manage Git interactively! Supports auto-init, staging (unstage/discard), and automatic fix for *dubious ownership* errors.
+- **🛡️ Backup Manager (bum)**: Smartly backup your project. Ignores heavy folders (`node_modules`) while keeping sensitive files (`.env`).
+- **⚡ Global Shorthands**: One-letter commands for common tasks (Reload, Clear screen, IP Info, etc).
+- **🎨 Interactive Interface**: User-friendly menu powered by `questionary`.
+
+---
+
+## 🛠️ Installation
+
+### From Source (Recommended for Global Shorthands)
+1. Clone this repository.
+2. Enter the project folder.
+3. Run the following command:
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 Usage Guide
+
+### 1. Interactive Menu
+Run the tool with your preferred language to open the navigation menu:
+- **`sendok en`** : Menu in English (Default).
+- **`sendok id`** : Menu in Indonesian.
+- **`sendok es`** : Menu in Spanish.
+- **`sendok ja`** : Menu in Japanese.
+- **`sendok zh`** : Menu in Chinese.
+
+### 2. Global Shorthands (Direct in Terminal)
+After installation, you can use these commands directly from your terminal:
+
+| Command | Function |
+| :--- | :--- |
+| **`r`** | Refresh terminal & VS Code UI |
+| **`gg`** | Run Git GUI Helper (Interactive) |
+| **`c`** | Clear terminal screen (`cls` or `clear`) |
+| **`p`** | Show IP information (`ipconfig` or `ifconfig`) |
+| **`bum`** | Run Backup Manager for the current folder |
+| **`lll`** | Run `npm run build` |
+| **`bum`** | Run Backup Manager for the current folder |
+
+### 3. Git Helper (`gg`) Features
+Use the **`gg`** command for easier Git management without memorizing terminal commands:
+
+| Menu Action | Git Command Equivalent | Description |
+| :--- | :--- | :--- |
+| **Auto-Init** | `git init` | Automatically creates a repo if not found. |
+| **Staging** | `git add` | Add files to the commit queue. |
+| **Unstage** | `git reset` | Remove files from the queue (safe). |
+| **Discard** | `git restore` | Discard edits & reset file (be careful!). |
+| **Commit** | `git commit` | Record changes permanently. |
+| **Push/Pull** | `git push/pull` | Sync with server (GitLab/GitHub). |
+| **Branch** | `git branch` | Manage coding branches. |
+| **Remove Git** | `rd /s /q .git` | Restore folder to normal (delete Git). |
+| **Auto-Fix** | `git config ...` | Automatically fix *dubious ownership* errors. |
+
+### 4. Standard Subcommands
+- **`sendok init [id|en|es|ja|zh]`**: Create documentation folder.
+- **`sendok reload`**: Refresh terminal and VS Code UI.
+- **`sendok list`**: View available documentation templates.
+- **`sendok clean`**: Delete `docs/` folder.
+- **`sendok about`**: Show application developer information.
+
+---
+
+## 🛡️ Backup Manager (bum)
+
+The `bum` feature creates a timestamped backup folder at `.bum/[project_folder]-[date]-[time]`.
+This process automatically ignores:
+- `node_modules`, `.git`, `venv`, `.venv`
+- `dist`, `build`, `__pycache__`
+- The `.bum` folder itself (to avoid recursion)
+
+---
+
+## 👤 Author
+- **Hasan Askari** (marhaendev)
+- **Website**: [hasanaskari.com](https://hasanaskari.com)
+- **Email**: marhaendev@gmail.com
+
+🥄 *Simple. Fast. Spooning documents like a pro!*

sendok-0.1.0/README.md

@@ -0,0 +1,94 @@
+# sendok 🥄
+
+**sendok** (Scaffolding Engine for Nimble Documentation Organizer Kit) is a simple and fast development tool to manage project documentation and speed up your terminal workflow.
+
+[🇮🇩 Bahasa Indonesia](README_id.md) | [🇪🇸 Español](README_es.md) | [🇯🇵 日本語](README_ja.md) | [🇨🇳 中文](README_zh.md)
+
+---
+
+## ✨ Key Features
+
+- **🚀 Instant Documentation**: Initialize `docs/` folder with standard templates (SSH, Git, Node, NVM, Angular, GitHub CLI).
+- **🌐 Multi-language Support**: Templates available in 5 languages (EN, ID, ES, JA, ZH).
+- **🍴 Git Helper (gg)**: Manage Git interactively! Supports auto-init, staging (unstage/discard), and automatic fix for *dubious ownership* errors.
+- **🛡️ Backup Manager (bum)**: Smartly backup your project. Ignores heavy folders (`node_modules`) while keeping sensitive files (`.env`).
+- **⚡ Global Shorthands**: One-letter commands for common tasks (Reload, Clear screen, IP Info, etc).
+- **🎨 Interactive Interface**: User-friendly menu powered by `questionary`.
+
+---
+
+## 🛠️ Installation
+
+### From Source (Recommended for Global Shorthands)
+1. Clone this repository.
+2. Enter the project folder.
+3. Run the following command:
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 Usage Guide
+
+### 1. Interactive Menu
+Run the tool with your preferred language to open the navigation menu:
+- **`sendok en`** : Menu in English (Default).
+- **`sendok id`** : Menu in Indonesian.
+- **`sendok es`** : Menu in Spanish.
+- **`sendok ja`** : Menu in Japanese.
+- **`sendok zh`** : Menu in Chinese.
+
+### 2. Global Shorthands (Direct in Terminal)
+After installation, you can use these commands directly from your terminal:
+
+| Command | Function |
+| :--- | :--- |
+| **`r`** | Refresh terminal & VS Code UI |
+| **`gg`** | Run Git GUI Helper (Interactive) |
+| **`c`** | Clear terminal screen (`cls` or `clear`) |
+| **`p`** | Show IP information (`ipconfig` or `ifconfig`) |
+| **`bum`** | Run Backup Manager for the current folder |
+| **`lll`** | Run `npm run build` |
+| **`bum`** | Run Backup Manager for the current folder |
+
+### 3. Git Helper (`gg`) Features
+Use the **`gg`** command for easier Git management without memorizing terminal commands:
+
+| Menu Action | Git Command Equivalent | Description |
+| :--- | :--- | :--- |
+| **Auto-Init** | `git init` | Automatically creates a repo if not found. |
+| **Staging** | `git add` | Add files to the commit queue. |
+| **Unstage** | `git reset` | Remove files from the queue (safe). |
+| **Discard** | `git restore` | Discard edits & reset file (be careful!). |
+| **Commit** | `git commit` | Record changes permanently. |
+| **Push/Pull** | `git push/pull` | Sync with server (GitLab/GitHub). |
+| **Branch** | `git branch` | Manage coding branches. |
+| **Remove Git** | `rd /s /q .git` | Restore folder to normal (delete Git). |
+| **Auto-Fix** | `git config ...` | Automatically fix *dubious ownership* errors. |
+
+### 4. Standard Subcommands
+- **`sendok init [id|en|es|ja|zh]`**: Create documentation folder.
+- **`sendok reload`**: Refresh terminal and VS Code UI.
+- **`sendok list`**: View available documentation templates.
+- **`sendok clean`**: Delete `docs/` folder.
+- **`sendok about`**: Show application developer information.
+
+---
+
+## 🛡️ Backup Manager (bum)
+
+The `bum` feature creates a timestamped backup folder at `.bum/[project_folder]-[date]-[time]`.
+This process automatically ignores:
+- `node_modules`, `.git`, `venv`, `.venv`
+- `dist`, `build`, `__pycache__`
+- The `.bum` folder itself (to avoid recursion)
+
+---
+
+## 👤 Author
+- **Hasan Askari** (marhaendev)
+- **Website**: [hasanaskari.com](https://hasanaskari.com)
+- **Email**: marhaendev@gmail.com
+
+🥄 *Simple. Fast. Spooning documents like a pro!*

sendok-0.1.0/README_es.md

@@ -0,0 +1,94 @@
+# sendok 🥄
+
+**sendok** (Scaffolding Engine for Nimble Documentation Organizer Kit) es una herramienta de desarrollo simple y rápida para gestionar la documentación de proyectos y acelerar tu flujo de trabajo en la terminal.
+
+[🇺🇸 English](README.md) | [🇮🇩 Bahasa Indonesia](README_id.md) | [🇯🇵 日本語](README_ja.md) | [🇨🇳 中文](README_zh.md)
+
+---
+
+## ✨ Características Principales
+
+- **🚀 Documentación Instantánea**: Inicializa la carpeta `docs/` con plantillas estándar (SSH, Git, Node, NVM, Angular, GitHub CLI).
+- **🌐 Soporte Multi-idioma**: Plantillas en 5 idiomas (EN, ID, ES, JA, ZH).
+- **🍴 Git Helper (gg)**: ¡Gestiona Git de forma interactiva! Soporta auto-init, staging (unstage/discard) y reparación automática de errores de *dubious ownership*.
+- **🛡️ Administrador de Respaldos (bum)**: Respalda tu proyecto de manera inteligente. Ignora carpetas pesadas (`node_modules`) manteniendo archivos sensibles (`.env`).
+- **⚡ Atajos Globales (Shorthands)**: Comandos de una sola letra para tareas comunes (Reload, Limpiar pantalla, Info de IP, etc.).
+- **🎨 Interfaz Interactiva**: Menú fácil de usar impulsado por `questionary`.
+
+---
+
+## 🛠️ Instalación
+
+### Desde el Código Fuente (Recomendado para Atajos Globales)
+1. Clona este repositorio.
+2. Ingresa a la carpeta del proyecto.
+3. Ejecuta el siguiente comando:
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 Guía de Uso
+
+### 1. Menú Interactivo
+Ejecuta la herramienta con tu idioma preferido para abrir el menú de navegación:
+- **`sendok es`** : Menú en Español.
+- **`sendok en`** : Menú en Inglés.
+- **`sendok id`** : Menú en Indonesio.
+- **`sendok ja`** : Menú en Japonés.
+- **`sendok zh`** : Menú en Chino.
+
+### 2. Atajos Globales (Directo en la Terminal)
+Después de la instalación, puedes usar estos comandos directamente desde tu terminal:
+
+| Comando | Función |
+| :--- | :--- |
+| **`r`** | Refrescar terminal y VS Code |
+| **`gg`** | Ejecutar Git GUI Helper (Interactivo) |
+| **`c`** | Limpiar la pantalla de la terminal (`cls` o `clear`) |
+| **`p`** | Mostrar información de IP (`ipconfig` o `ifconfig`) |
+| **`bum`** | Ejecutar el Administrador de Respaldos para la carpeta actual |
+| **`lll`** | Ejecutar `npm run build` |
+| **`bum`** | Ejecutar el Administrador de Respaldos para la carpeta actual |
+
+### 3. Características de Git Helper (`gg`)
+Usa el comando **`gg`** para una gestión de Git más sencilla sin memorizar comandos de la terminal:
+
+| Acción del Menú | Equivalente de Comando Git | Descripción |
+| :--- | :--- | :--- |
+| **Auto-Init** | `git init` | Crea automáticamente un repo si no se encuentra. |
+| **Staging** | `git add` | Añadir archivos a la cola de commit. |
+| **Unstage** | `git reset` | Quitar archivos de la cola (seguro). |
+| **Discard** | `git restore` | Descartar ediciones y resetear archivo (¡cuidado!). |
+| **Commit** | `git commit` | Registrar cambios de forma permanente. |
+| **Push/Pull** | `git push/pull` | Sincronizar con el servidor (GitLab/GitHub). |
+| **Branch** | `git branch` | Gestionar ramas de código. |
+| **Remove Git** | `rd /s /q .git` | Restaurar carpeta a la normalidad (borrar Git). |
+| **Auto-Fix** | `git config ...` | Corregir automáticamente errores de *dubious ownership*. |
+
+### 4. Subcomandos Estándar
+- **`sendok init [id|en|es|ja|zh]`**: Crear la carpeta de documentación.
+- **`sendok reload`**: Refrescar terminal y la interfaz de VS Code.
+- **`sendok list`**: Ver la lista de plantillas disponibles.
+- **`sendok clean`**: Eliminar la carpeta `docs/`.
+- **`sendok about`**: Mostrar información del desarrollador de la aplicación.
+
+---
+
+## 🛡️ Administrador de Respaldos (bum)
+
+La función `bum` crea una carpeta de respaldo con marca de tiempo en `.bum/[carpeta_del_proyecto]-[fecha]-[hora]`.
+Este proceso ignora automáticamente:
+- `node_modules`, `.git`, `venv`, `.venv`
+- `dist`, `build`, `__pycache__`
+- La carpeta `.bum` en sí misma (para evitar recursividad)
+
+---
+
+## 👤 Autor
+- **Hasan Askari** (marhaendev)
+- **Website**: [hasanaskari.com](https://hasanaskari.com)
+- **Correo electrónico**: marhaendev@gmail.com
+
+ 🥄 *¡Simple. Rápido. Documentando como un profesional!*

sendok-0.1.0/README_id.md

@@ -0,0 +1,94 @@
+# sendok 🥄
+
+**sendok** (Scaffolding Engine for Nimble Documentation Organizer Kit) adalah alat bantu pengembangan yang simpel dan cepat untuk mengelola dokumentasi proyek serta mempercepat alur kerja terminal Anda.
+
+[🇺🇸 English](README.md) | [🇪🇸 Español](README_es.md) | [🇯🇵 日本語](README_ja.md) | [🇨🇳 中文](README_zh.md)
+
+---
+
+## ✨ Fitur Utama
+
+- **🚀 Dokumentasi Instan**: Inisialisasi folder `docs/` dengan template standar (SSH, Git, Node, NVM, Angular, GitHub CLI).
+- **🌐 Dukungan Multi-bahasa**: Template tersedia dalam 5 bahasa (EN, ID, ES, JA, ZH).
+- **🍴 Git Helper (gg)**: Kelola Git secara interaktif! Mendukung auto-init, staging (unstage/discard), dan perbaikan otomatis error *dubious ownership*.
+- **🛡️ Backup Manager (bum)**: Cadangkan proyek Anda secara cerdas. Mengabaikan folder berat (`node_modules`) namun tetap menyertakan file penting (`.env`).
+- **⚡ Pintasan Global (Shorthands)**: Perintah satu huruf untuk tugas umum (Reload, Clear screen, IP Info, dll).
+- **🎨 Antarmuka Interaktif**: Menu yang ramah pengguna menggunakan `questionary`.
+
+---
+
+## 🛠️ Instalasi
+
+### Dari Source (Rekomendasi untuk Pintasan Global)
+1. Clone repositori ini.
+2. Masuk ke folder proyek.
+3. Jalankan perintah:
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 Panduan Penggunaan
+
+### 1. Menu Interaktif
+Jalankan alat dengan bahasa pilihan Anda untuk membuka menu navigasi:
+- **`sendok id`** : Menu dalam Bahasa Indonesia.
+- **`sendok en`** : Menu dalam Bahasa Inggris.
+- **`sendok es`** : Menu dalam Bahasa Spanyol.
+- **`sendok ja`** : Menu dalam Bahasa Jepang.
+- **`sendok zh`** : Menu dalam Bahasa Mandarin.
+
+### 2. Pintasan Global (Langsung di Terminal)
+Setelah instalasi, Anda dapat menggunakan perintah berikut dari mana saja tanpa prefix:
+
+| Perintah | Fungsi |
+| :--- | :--- |
+| **`r`** | Menyegarkan terminal & tampilan VS Code |
+| **`gg`** | Menjalankan Git GUI Helper (Interaktif) |
+| **`c`** | Membersihkan layar terminal (`cls` atau `clear`) |
+| **`p`** | Menampilkan informasi IP (`ipconfig` atau `ifconfig`) |
+| **`bum`** | Menjalankan Backup Manager untuk folder saat ini |
+| **`lll`** | Menjalankan `npm run build` |
+| **`bum`** | Menjalankan Backup Manager untuk folder saat ini |
+
+### 3. Fitur Git Helper (`gg`)
+Gunakan perintah **`gg`** untuk manajemen Git yang lebih mudah tanpa perlu hafal perintah terminal:
+
+| Aksi di Menu | Padanan Perintah Git | Deskripsi |
+| :--- | :--- | :--- |
+| **Auto-Init** | `git init` | Otomatis membuat repo jika belum ada. |
+| **Staging** | `git add` | Memasukkan file ke antrean commit. |
+| **Unstage** | `git reset` | Mengeluarkan file dari antrean (aman). |
+| **Discard** | `git restore` | Membuang editan & reset file (hati-hati!). |
+| **Commit** | `git commit` | Mencatat perubahan secara permanen. |
+| **Push/Pull** | `git push/pull` | Sinkronisasi dengan server (GitLab/GitHub). |
+| **Branch** | `git branch` | Kelola cabang kodingan. |
+| **Remove Git** | `rd /s /q .git` | Balikin folder jadi normal (hapus Git). |
+| **Auto-Fix** | `git config ...` | Otomatis benerin error *dubious ownership*. |
+
+### 4. Perintah Standar (Subcommands)
+- **`sendok init [id|en|es|ja|zh]`**: Membuat folder dokumentasi.
+- **`sendok reload`**: Menyegarkan terminal dan tampilan VS Code.
+- **`sendok list`**: Melihat daftar template yang tersedia.
+- **`sendok clean`**: Menghapus folder `docs/`.
+- **`sendok about`**: Informasi pembuat aplikasi.
+
+---
+
+## 🛡️ Backup Manager (bum)
+
+Fitur `bum` akan membuat folder di `.bum/[folder_proyek]-[tanggal]-[jam]`.
+Proses ini secara otomatis mengabaikan:
+- `node_modules`, `.git`, `venv`, `.venv`
+- `dist`, `build`, `__pycache__`
+- Folder `.bum` itu sendiri (menghindari rekursif)
+
+---
+
+## 👤 Pembuat
+- **Hasan Askari** (marhaendev)
+- **Website**: [hasanaskari.com](https://hasanaskari.com)
+- **Email**: marhaendev@gmail.com
+
+🥄 *Simpel. Cepat. Menyendok dokumen dengan mahir!*

sendok-0.1.0/README_ja.md

@@ -0,0 +1,94 @@
+# sendok 🥄
+
+**sendok** (Scaffolding Engine for Nimble Documentation Organizer Kit) は、プロジェクトのドキュメント作成を管理し、ターミナルのワークフローを高速化するための、シンプルで高速な開発ツールです。
+
+[🇺🇸 English](README.md) | [🇮🇩 Bahasa Indonesia](README_id.md) | [🇪🇸 Español](README_es.md) | [🇨🇳 中文](README_zh.md)
+
+---
+
+## ✨ 主な機能
+
+- **🚀 インスタントドキュメント**: 標準テンプレート（SSH、Git、Node、NVM、Angular、GitHub CLI）を使用して `docs/` フォルダを初期化します。
+- **🌐 多言語サポート**: 5つの言語（EN、ID、ES、JA、ZH）のテンプレートが利用可能です。
+- **🍴 Git Helper (gg)**: Git を対話的に管理！Auto-init、Staging (Unstage/Discard)、*dubious ownership* エラーの自動修復をサポートします。
+- **🛡️ バックアップマネージャー (bum)**: プロジェクトをスマートにバックアップします。重いフォルダ (`node_modules`) を無視し、重要なファイル (`.env`) は保持します。
+- **⚡ グローバルショートハンド**: 一般的なタスク用の1文字コマンド（Reload、画面クリア、IP情報など）。
+- **🎨 インタラクティブインターフェース**: `questionary` を使用した使いやすいメニュー。
+
+---
+
+## 🛠️ インストール
+
+### ソースから（グローバルショートハンドに推奨）
+1. このリポジトリをクローンします。
+2. プロジェクトフォルダに入ります。
+3. 次のコマンドを実行します：
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 使用方法
+
+### 1. インタラクティブメニュー
+お好みの言語でツールを実行して、ナビゲーションメニューを開きます：
+- **`sendok ja`** : 日本語メニュー。
+- **`sendok en`** : 英語メニュー。
+- **`sendok id`** : インドネシア語メニュー。
+- **`sendok es`** : スペイン語メニュー。
+- **`sendok zh`** : 中国語メニュー。
+
+### 2. グローバルショートハンド（ターミナルで直接）
+インストール後、ターミナルから直接これらのコマンドを使用できます：
+
+| コマンド | 機能 |
+| :--- | :--- |
+| **`r`** | ターミナルと VS Code を更新 |
+| **`gg`** | Git GUI ヘルパーを実行する (対話型) |
+| **`c`** | ターミナル画面をクリア (`cls` または `clear`) |
+| **`p`** | IP情報を表示 (`ipconfig` または `ifconfig`) |
+| **`bum`** | 現在のフォルダに対してバックアップマネージャーを実行 |
+| **`lll`** | `npm run build` を実行 |
+| **`bum`** | 現在のフォルダに対してバックアップマネージャーを実行 |
+
+### 3. Git Helper (`gg`) の機能
+ターミナルコマンドを覚えなくても、**`gg`** コマンドで簡単に Git を管理できます：
+
+| メニューアクション | 対応する Git コマンド | 説明 |
+| :--- | :--- | :--- |
+| **Auto-Init** | `git init` | レポジトリがない場合に自動で作成します。 |
+| **Staging** | `git add` | ファイルをコミット待ち状態に追加します。 |
+| **Unstage** | `git reset` | ファイルを待ち状態から除外します（安全）。 |
+| **Discard** | `git restore` | 編集を破棄してファイルをリセットします（注意！）。 |
+| **Commit** | `git commit` | 変更を永続的に記録します。 |
+| **Push/Pull** | `git push/pull` | サーバー（GitLab/GitHub）と同期します。 |
+| **Branch** | `git branch` | コーディングのブランチを管理します。 |
+| **Remove Git** | `rd /s /q .git` | フォルダを通常の状態に戻します（Gitを削除）。 |
+| **Auto-Fix** | `git config ...` | *dubious ownership* エラーを自動で修復します。 |
+
+### 4. 標準サブコマンド
+- **`sendok init [id|en|es|ja|zh]`**: ドキュメントフォルダを作成。
+- **`sendok reload`**: ターミナルと VS Code の UI を更新。
+- **`sendok list`**: 利用可能なドキュメントテンプレートを表示。
+- **`sendok clean`**: `docs/` フォルダを削除。
+- **`sendok about`**: アプリ開発者の情報を表示。
+
+---
+
+## 🛡️ バックアップマネージャー (bum)
+
+`bum` 機能は、`.bum/[プロジェクトフォルダ]-[日付]-[時刻]` にタイムスタンプ付きのバックアップフォルダを作成します。
+このプロセスは以下を自動的に無視します：
+- `node_modules`, `.git`, `venv`, `.venv`
+- `dist`, `build`, `__pycache__`
+- `.bum` フォルダ自体（再帰を避けるため）
+
+---
+
+## 👤 著者
+- **Hasan Askari** (marhaendev)
+- **Website**: [hasanaskari.com](https://hasanaskari.com)
+- **メール**: marhaendev@gmail.com
+
+ 🥄 *シンプル。スピーディ。プロのようにドキュメントを作成！*

sendok-0.1.0/README_zh.md

@@ -0,0 +1,94 @@
+# sendok 🥄
+
+**sendok** (Scaffolding Engine for Nimble Documentation Organizer Kit) 是一个简单快捷的开发工具，用于管理项目文档并加快终端工作流。
+
+[🇺🇸 English](README.md) | [🇮🇩 Bahasa Indonesia](README_id.md) | [🇪🇸 Español](README_es.md) | [🇯🇵 日本語](README_ja.md)
+
+---
+
+## ✨ 主要功能
+
+- **🚀 即时文档**: 使用标准模板（SSH、Git、Node、NVM、Angular、GitHub CLI）初始化 `docs/` 文件夹。
+- **🌐 多语言支持**: 支持 5 种语言（EN、ID、ES、JA、ZH）。
+- **🍴 Git Helper (gg)**: 交互式管理 Git！支持 auto-init、staging (unstage/discard) 以及自动修复 *dubious ownership* 错误。
+- **🛡️ 备份管理器 (bum)**: 一键智能备份项目。自动忽略庞大文件夹 (`node_modules`)，同时保留敏感文件 (`.env`)。
+- **⚡ 全局快捷命令 (Shorthands)**: 常用任务的单字母命令（Reload、清屏、IP 信息等）。
+- **🎨 交互式界面**: 基于 `questionary` 的用户友好菜单。
+
+---
+
+## 🛠️ 安装
+
+### 从源码安装（推荐用于全局快捷命令）
+1. 克隆此仓库。
+2. 进入项目文件夹。
+3. 运行以下命令：
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 使用指南
+
+### 1. 交互式菜单
+使用你偏好的语言运行工具以打开导航菜单：
+- **`sendok zh`** : 中文菜单。
+- **`sendok en`** : 英文菜单。
+- **`sendok id`** : 印尼语菜单。
+- **`sendok es`** : 西班牙语菜单。
+- **`sendok ja`** : 日语菜单。
+
+### 2. 全局快捷命令（直接在终端运行）
+安装后，你可以直接从终端使用这些命令：
+
+| 命令 | 功能 |
+| :--- | :--- |
+| **`r`** | 刷新终端和 VS Code |
+| **`gg`** | 运行 Git GUI 助手 (交互式) |
+| **`c`** | 清除终端屏幕 (`cls` 或 `clear`) |
+| **`p`** | 显示 IP 信息 (`ipconfig` 或 `ifconfig`) |
+| **`bum`** | 对当前文件夹运行备份管理器 |
+| **`lll`** | 运行 `npm run build` |
+| **`bum`** | 对当前文件夹运行备份管理器 |
+
+### 3. Git Helper (`gg`) 功能详解
+无需记忆终端命令，使用 **`gg`** 命令即可轻松管理 Git：
+
+| 菜单操作 | 对应 Git 命令 | 描述 |
+| :--- | :--- | :--- |
+| **自动初始化** | `git init` | 如果未发现仓库，则自动创建。 |
+| **暂存 (Staging)** | `git add` | 将文件添加到提交队列。 |
+| **取消暂存** | `git reset` | 从队列中移除文件（安全）。 |
+| **丢弃更改** | `git restore` | 丢弃所有修改并重置文件（小心使用！）。 |
+| **提交 (Commit)** | `git commit` | 永久记录更改。 |
+| **推送/拉取** | `git push/pull` | 与服务器（GitLab/GitHub）同步。 |
+| **分支管理** | `git branch` | 管理代码分支。 |
+| **移除 Git** | `rd /s /q .git` | 将文件夹复原（删除 Git 配置）。 |
+| **自动修复** | `git config ...` | 自动修复 *dubious ownership* 安全错误。 |
+
+### 4. 标准子命令
+- **`sendok init [id|en|es|ja|zh]`**: 创建文档文件夹。
+- **`sendok reload`**: 刷新终端和 VS Code 界面。
+- **`sendok list`**: 查看可用文档模板列表。
+- **`sendok clean`**: 删除 `docs/` 文件夹。
+- **`sendok about`**: 显示应用开发人员信息。
+
+---
+
+## 🛡️ 备份管理器 (bum)
+
+`bum` 功能会在 `.bum/[项目文件夹]-[日期]-[时间]` 创建一个带有时间戳的备份文件夹。
+此过程会自动忽略：
+- `node_modules`, `.git`, `venv`, `.venv`
+- `dist`, `build`, `__pycache__`
+- `.bum` 文件夹本身（避免递归）
+
+---
+
+## 👤 作者
+- **Hasan Askari** (marhaendev)
+- **Website**: [hasanaskari.com](https://hasanaskari.com)
+- **电子邮件**: marhaendev@gmail.com
+
+ 🥄 *简单。快速。像专业人士一样编写文档！*

sendok-0.1.0/docs/angular.md

@@ -0,0 +1,70 @@
+# Panduan Angular CLI
+
+Angular CLI (Command Line Interface) adalah alat untuk membuat, mengembangkan, dan memelihara aplikasi Angular langsung dari terminal.
+
+---
+
+## 1. Instalasi Angular CLI
+Instal secara global agar perintah `ng` bisa digunakan di mana saja:
+```powershell
+npm install -g @angular/cli
+```
+Cek versi:
+```powershell
+ng version
+```
+
+## 2. Membuat Proyek Baru
+```powershell
+ng new nama-proyek-anda
+```
+*Tips: Pilih opsi CSS/SCSS dan Routing sesuai kebutuhan proyek.*
+
+## 3. Menjalankan Aplikasi (Development)
+```powershell
+# Menjalankan server lokal (biasanya di localhost:4200)
+ng serve
+
+# Menjalankan dan otomatis membuka browser
+ng serve -o
+
+# Menjalankan di port berbeda
+ng serve --port 5000
+```
+
+## 4. Generate (Membuat Komponen Baru)
+Angular CLI sangat membantu dalam membuat struktur file yang rapi dan standar.
+
+| Perintah | Singkatan | Deskripsi |
+| :--- | :--- | :--- |
+| `ng generate component` | `ng g c` | Membuat komponen baru (html, css, ts, spec). |
+| `ng generate service` | `ng g s` | Membuat service untuk logika data. |
+| `ng generate module` | `ng g m` | Membuat modul baru. |
+| `ng generate interface` | `ng g i` | Membuat tipe data/interface. |
+
+Contoh: `ng g c components/header`
+
+## 5. Build untuk Produksi
+Jika aplikasi sudah siap dideploy ke server:
+```powershell
+ng build --configuration production
+```
+Hasil build akan muncul di folder `/dist`.
+
+## 6. Testing & Linting
+```powershell
+# Menjalankan unit test (Karma/Jasmine)
+ng test
+
+# Mengecek kualitas kode (linting)
+ng lint
+```
+
+## 7. Tips Angular CLI
+- **Dry Run**: Ingin tahu file apa saja yang akan dibuat tanpa benar-benar membuatnya? Gunakan flag `--dry-run`.
+  Contoh: `ng g c test-komponen --dry-run`
+- **Inline Style/Template**: Jika komponen sangat sederhana, gunakan:
+  `ng g c simpel --inline-style --inline-template`
+
+---
+*Angular CLI memastikan standarisasi kode yang rapi untuk proyek skala besar.*