README file from
Github🔄 Recursive Share for Obsidian
Version: 1.0.0 | Requires Obsidian: 0.15.0+
📋 Table of Contents
🌟 Overview
With Recursive Share for Obsidian, you can create share links including images, drawings, and other embeds.
Recursive Share for Obsidian is a third-party plugin for Obsidian.
✨ Features
- 📤 Share individual notes with others
- 🔄 Include linked attachments
- 🔒 Control who can share by configuring the backend
- 🌐 Generate shareable links for your content
- 🖼️ Support for embedded images and other media
📥 Installation
From Obsidian Community Plugins
- Open Obsidian
- Go to Settings → Community plugins
- Disable Safe mode if it's enabled
- Click on Browse and search for "Recursive Share"
- Click Install, then Enable
Manual Installation
- Download the latest release from the GitHub releases page
- Extract the ZIP file into your Obsidian vault's
.obsidian/plugins/folder - Enable the plugin in Obsidian's Community Plugins settings
Setting up the backend
To set up the backend, use the docker image provided
at cbergschneider/recursive-share-backend.
Provide a config file as a mount at /app/settings.toml. This could look like this:
port = 8181
auth_tokens = [ "development" ]
storage_path = "storage"
With this configuration, you should add a volume to /app/storage and a port forward for port 8181.
To configure rocket further, you can add a rocket.toml to /app.
See their docs for more info.
🚀 Usage
- Set up the backend service and connect it to your vault
- Use Ctrl+P to open the command palette
- Execute the "Recursive Share: Share Recursively"
- ???
- Profit
⚙️ Configuration
The plugin requires the following settings:
- Server URI: The URI of the sharing server
- API Key: Your personal API key for authentication
You can configure these in the plugin settings tab.
👥 Contributing
We welcome contributions to Recursive Share for Obsidian! Whether it's bug fixes, feature additions, or documentation improvements, your help is appreciated.
🛣️ Contribution Workflow
-
Fork the Repository: Start by forking the repository on GitHub.
-
Create a Branch: Create a branch for your work.
git checkout -b feature/your-amazing-feature -
Make Your Changes: Implement your changes, following the existing code style.
-
Test Thoroughly: Ensure your changes work as expected and don't break existing functionality.
-
Update Documentation: Update the README or other documentation if necessary.
-
Submit a Pull Request: Push your changes to your fork and submit a pull request.
git push origin feature/your-amazing-feature
📋 Contribution Guidelines
- Code Style: Follow the existing code style and TypeScript best practices.
- Commit Messages: Write clear, concise commit messages that explain your changes.
- Documentation: Add comments to your code and update documentation when necessary.
- Testing: Test your changes thoroughly before submitting a pull request.
- Issues: Create an issue before starting work on significant changes.
📄 License
This project is licensed under the MIT License.
🆘 Support
Need help with Recursive Share for Obsidian? We're here to assist you! If you encounter a bug or have a feature request:
- Check the GitHub Issues to see if it has already been reported.
- If not, create a new issue with:
- A clear, descriptive title
- Detailed steps to reproduce the issue
- Information about your environment (Obsidian version, OS, etc.)
- Screenshots if applicable
🔍 Troubleshooting Tips
Before reaching out for support, try these troubleshooting steps:
- Update the Plugin: Make sure you're using the latest version
- Restart Obsidian: Many issues can be resolved with a simple restart
- Check Console Errors: Open the developer console (Ctrl+Shift+I) to check for errors
- Disable Other Plugins: Temporarily disable other plugins to check for conflicts
- Try in a New Vault: Test if the issue persists in a clean vault