Release v1.2.0 - Local Backup & Markdown Desktop Integration
✨ New Features: - Local backup/restore system with 3 modes (Merge/Replace/Overwrite) - Markdown export for desktop access via WebDAV mount - Dual-format architecture (JSON master + Markdown mirror) - Settings UI extended with backup & desktop integration sections 📝 Changes: - Server restore now asks for mode selection (user safety) - WebDAV mount instructions for Windows/Mac/Linux in README - Complete CHANGELOG.md with all version history 🔧 Technical: - BackupManager.kt for complete backup/restore logic - Note.toMarkdown/fromMarkdown with YAML frontmatter - ISO8601 timestamps for desktop compatibility - Last-Write-Wins conflict resolution 📚 Documentation: - CHANGELOG.md (Keep a Changelog format) - README updates (removed Joplin/Obsidian, added WebDAV-mount) - F-Droid changelogs (DE+EN, under 500 chars) - SYNC_ARCHITECTURE.md in project-docs - MARKDOWN_DESKTOP_REALITY_CHECK.md strategic plan - WEB_EDITOR_PLAN_v1.3.0.md for future web editor feature
This commit is contained in:
117
README.en.md
117
README.en.md
@@ -29,11 +29,25 @@
|
||||
* Swipe-to-delete with confirmation
|
||||
* Material Design 3 editor
|
||||
|
||||
### 💾 Backup & Restore **NEW in v1.2.0**
|
||||
* **Local backup** - Export all notes as JSON file
|
||||
* **Flexible restore** - 3 modes (Merge, Replace, Overwrite)
|
||||
* **Automatic safety net** - Auto-backup before every restore
|
||||
* **Independent from server** - Works completely offline
|
||||
|
||||
### 🖥️ Desktop Integration **NEW in v1.2.0**
|
||||
* **Markdown export** - Notes are automatically exported as `.md` files
|
||||
* **WebDAV access** - Mount WebDAV as network drive for direct access
|
||||
* **Editor compatibility** - VS Code, Typora, Notepad++, or any Markdown editor
|
||||
* **Last-Write-Wins** - Intelligent conflict resolution via timestamps
|
||||
* **Dual-format** - JSON sync remains master, Markdown is optional mirror
|
||||
|
||||
### 🔄 Synchronization
|
||||
* **Pull-to-refresh** for manual sync
|
||||
* **Auto-sync** (15/30/60 min) only on home WiFi
|
||||
* **Smart server check** - No errors on foreign networks
|
||||
* **Conflict-free merging** - Your changes are never lost
|
||||
* **6 sync triggers** - Periodic, app-start, WiFi, manual, pull-to-refresh, settings
|
||||
|
||||
### 🔒 Privacy & Self-Hosted
|
||||
* **WebDAV server** (Nextcloud, ownCloud, etc.)
|
||||
@@ -73,7 +87,98 @@ docker compose up -d
|
||||
|
||||
---
|
||||
|
||||
## 📚 Documentation
|
||||
## <EFBFBD> Local Backup & Restore
|
||||
|
||||
### Create Backup
|
||||
|
||||
1. **Settings** → **Backup & Restore**
|
||||
2. Tap **"📥 Create backup"**
|
||||
3. Choose location (Downloads, SD card, cloud folder)
|
||||
4. Done! All notes are saved in a `.json` file
|
||||
|
||||
**Filename:** `simplenotes_backup_YYYY-MM-DD_HHmmss.json`
|
||||
|
||||
### Restore
|
||||
|
||||
1. **Settings** → **"📤 Restore from file"**
|
||||
2. Select backup file
|
||||
3. **Choose restore mode:**
|
||||
- **Merge** _(Default)_ - Add new notes, keep existing ones
|
||||
- **Replace** - Delete all and import backup
|
||||
- **Overwrite duplicates** - Backup wins on ID conflicts
|
||||
4. Confirm - _Automatic safety backup is created!_
|
||||
|
||||
**💡 Tip:** Before every restore, an automatic safety backup is created - your data is safe!
|
||||
|
||||
---
|
||||
|
||||
## 🖥️ Desktop Integration (WebDAV + Markdown)
|
||||
|
||||
### Why Markdown?
|
||||
|
||||
The app automatically exports your notes as `.md` files so you can edit them on desktop:
|
||||
|
||||
- **JSON remains master** - Primary sync mechanism (reliable, fast)
|
||||
- **Markdown is mirror** - Additional export for desktop access
|
||||
- **Dual-format** - Both formats are always in sync
|
||||
|
||||
### Setup: WebDAV as Network Drive
|
||||
|
||||
**With WebDAV mount ANY Markdown editor works!**
|
||||
|
||||
#### Windows:
|
||||
|
||||
1. **Open Explorer** → Right-click on "This PC"
|
||||
2. **"Map network drive"**
|
||||
3. **Enter WebDAV URL:** `http://YOUR-SERVER:8080/notes-md/`
|
||||
4. Enter username/password
|
||||
5. **Done!** - Folder appears as drive (e.g. Z:\)
|
||||
|
||||
#### macOS:
|
||||
|
||||
1. **Finder** → Menu "Go" → "Connect to Server" (⌘K)
|
||||
2. **Server Address:** `http://YOUR-SERVER:8080/notes-md/`
|
||||
3. Enter username/password
|
||||
4. **Done!** - Folder appears under "Network"
|
||||
|
||||
#### Linux:
|
||||
|
||||
```bash
|
||||
# Option 1: GNOME Files / Nautilus
|
||||
Files → Other Locations → Connect to Server
|
||||
Server Address: dav://YOUR-SERVER:8080/notes-md/
|
||||
|
||||
# Option 2: davfs2 (permanent mount)
|
||||
sudo apt install davfs2
|
||||
sudo mount -t davfs http://YOUR-SERVER:8080/notes-md/ /mnt/notes
|
||||
```
|
||||
|
||||
### Workflow:
|
||||
|
||||
1. **Enable Markdown export** (App → Settings)
|
||||
2. **Mount WebDAV** (see above)
|
||||
3. **Open editor** (VS Code, Typora, Notepad++, etc.)
|
||||
4. **Edit notes** - Changes are saved directly
|
||||
5. **"Import Markdown Changes" in app** - Import desktop changes
|
||||
|
||||
**Recommended Editors:**
|
||||
- **VS Code** - Free, powerful, with Markdown preview
|
||||
- **Typora** - Minimalist, WYSIWYG Markdown
|
||||
- **Notepad++** - Lightweight, fast
|
||||
- **iA Writer** - Focused writing
|
||||
|
||||
- **VS Code** with WebDAV extension
|
||||
- **Typora** (local copy)
|
||||
- **iA Writer** (read/edit only, no auto-sync)
|
||||
|
||||
**⚠️ Important:**
|
||||
- Markdown export is **optional** (toggle in settings)
|
||||
- JSON sync **always** works - Markdown is additional
|
||||
- All 6 sync triggers remain unchanged
|
||||
|
||||
---
|
||||
|
||||
## <20>📚 Documentation
|
||||
|
||||
- **[Quick Start Guide](QUICKSTART.en.md)** - Step-by-step guide for end users
|
||||
- **[Server Setup](server/README.en.md)** - Configure WebDAV server
|
||||
@@ -98,8 +203,14 @@ Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
||||
|
||||
---
|
||||
|
||||
## 📄 License
|
||||
## <EFBFBD> Changelog
|
||||
|
||||
All changes are documented in [CHANGELOG.md](CHANGELOG.md).
|
||||
|
||||
---
|
||||
|
||||
## <20>📄 License
|
||||
|
||||
MIT License - see [LICENSE](LICENSE)
|
||||
|
||||
**v1.1.2** · Built with Kotlin + Material Design 3
|
||||
**v1.2.0** · Built with Kotlin + Material Design 3
|
||||
|
||||
Reference in New Issue
Block a user