Merge pull request #981 from SatoshiPortal/develop

5.3.1

Author: i5hi

.github/workflows/documentation.yml

@@ -0,0 +1,19 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@v4
+      - name: build_and_deploy
+        uses: shalzz/zola-deploy-action@master
+        env:
+          PAGES_BRANCH: gh-pages
+          TOKEN: ${{ secrets.TOKEN_GH_PAGES }}

.gitignore

@@ -1,5 +1,13 @@
 # See https://www.dartlang.org/guides/libraries/private-files
 
+# Zola
+docs/zola/public/
+
+# # Untrack unused platform files
+macos/
+linux/
+windows/
+
 # Files and directories created by pub
 .dart_tool/
 .packages

analysis_options.yaml

@@ -6,6 +6,7 @@ linter:
     avoid_dynamic_calls: false
     no_wildcard_variable_uses: false
     unawaited_futures: true
+    avoid_redundant_argument_values: false
 
 
 analyzer:

docs/jks.md docs/old/jks.mddocs/jks.md renamed to docs/old/jks.md

@@ -0,0 +1,49 @@
+# The URL the site will be built for
+base_url = "https://example.com"
+
+# The site title
+title = "BULL Documentation"
+
+theme = "radion"
+
+# Whether to automatically compile all Sass files in the sass directory
+compile_sass = false
+
+# Whether to build a search index to be used later on by a JavaScript library
+build_search_index = true
+
+# Taxonomies configuration for the theme
+taxonomies = [
+    {name = "categories", feed = true},
+    {name = "tags", feed = true},
+]
+
+[markdown]
+# Whether to do syntax highlighting
+# Theme can be customised by setting the `highlight_theme` variable to a theme supported by Zola
+highlight_code = true
+
+[extra]
+radion_menu = [
+    {url = "$BASE_URL", name = "Home"},
+    {url = "$BASE_URL/categories", name = "Categories"},
+    {url = "$BASE_URL/tags", name = "Tags"},
+]
+codeblock = true
+github = "https://github.com/SatoshiPortal/bullbitcoin-mobile"
+paginate_by = 5
+# Disable comments to avoid giscus errors
+comments = false
+
+enable_search = true
+theme = "toggle" # Light and Dark Modes
+
+
+[search]
+index_format = "elasticlunr_json"
+
+
+
+
+
+

docs/pgp.md docs/old/pgp.mddocs/pgp.md renamed to docs/old/pgp.md

@@ -0,0 +1,7 @@
++++
+title = "BULL Documentation"
+description = "Documentation for Bull Bitcoin mobile app"
+paginate_by = 5
++++
+
+Welcome to the Bull Bitcoin mobile app documentation. 

docs/security.md docs/old/security.mddocs/security.md renamed to docs/old/security.md

@@ -0,0 +1,142 @@
++++
+title = "Documentation Guide"
+description = "How to work with Bull Mobile documentation using Zola"
+date = 2025-07-04
+authors = ["ethicnology"]
+
+[taxonomies]
+categories = ["dev"]
+tags = ["documentation", "zola"]
+
+[extra]
+toc = true
++++
+
+This guide explains how to work with Bull Mobile's documentation system built with [Zola](https://www.getzola.org/).
+
+## What is Zola?
+
+Zola is a fast static site generator written in Rust. It's used to build our documentation site from Markdown files.
+
+## Project Structure
+
+```
+docs/zola/
+├── config.toml          # Site configuration
+├── content/             # Markdown content files
+│   ├── _index.md        # Homepage
+│   ├── getting-started.md
+│   ├── security.md
+│   └── ...
+├── static/              # Static assets (images, videos, etc.)
+│   ├── bull/
+│   └── coldcard-q/
+├── themes/              # Zola theme (radion)
+└── templates/           # Custom templates (if needed)
+```
+
+## Adding New Content
+
+### Creating a New Page
+
+1. Create a new `.md` file in the `content/` directory
+2. Add frontmatter at the top:
+
+```markdown
++++
+title = "Watch-Only Wallets"
+description = "Descriptors, xpub, ypub, zpub…"
+date = 2025-07-04
+authors = ["ethicnology", "ishi"]
+
+[taxonomies]
+categories = ["guides"]
+tags = ["watch only", "ColdCard Q", "wallet"]
+
+[extra]
+toc = true
++++
+
+Your content here...
+```
+
+### Frontmatter Options
+
+- **title**: Page title (required)
+- **description**: Page description for SEO
+- **date**: Publication date
+- **taxonomies**: Categories and tags for organization
+- **extra.toc**: Enable table of contents
+
+### Available Categories
+
+- `guides` - How-to guides and tutorials
+- `security` - Security-related content
+- `technical` - Technical documentation
+- `dev` - Developer documentation
+- `support` - Support and troubleshooting
+
+## Code Blocks
+
+### Syntax Highlighting
+
+```dart
+// Dart code example
+class WalletService {
+  Future<void> initializeWallet() async {
+    // Your code here
+  }
+}
+```
+
+### Configuration Examples
+
+```toml
+[network]
+network_type = "mainnet"
+```
+
+```json
+{
+  "servers": [
+    "electrum.example.com:50002"
+  ]
+}
+```
+
+## Building and Serving
+
+### Development Server
+
+```bash
+cd docs/zola
+zola serve
+```
+
+This starts a local server at `http://127.0.0.1:1111`
+
+### Build for Production
+
+```bash
+cd docs/zola
+zola build
+```
+
+This creates a `public/` directory with the built site.
+
+## Theme Features
+
+The radion theme provides:
+
+- **Dark/Light Mode**: Toggle in the top navigation
+- **Search**: Full-text search across all content
+- **Categories & Tags**: Browse content by topic
+- **Table of Contents**: Auto-generated for pages with `toc = true`
+- **Code Highlighting**: Syntax highlighting for code blocks
+- **Responsive Design**: Works on mobile and desktop
+
+### Getting Help
+
+- [Zola Documentation](https://www.getzola.org/documentation/getting-started/overview/)
+- [Radion Theme Documentation](https://github.com/micahkepe/radion)
+- Check existing content for examples