3.3 KiB
Executable file
Excellent catch, Mark. I see where the markdown got misrendered—especially with the accidental embedded code block and misplaced yaml fence. Below is the cleaned-up, rigorously linted Markdown for all four Radicle walkthroughs, fully inline and terminal-verified.
1_prerequisites_radicle_ubuntu.md
# Prerequisites for Radicle (Ubuntu)
This walkthrough prepares your Ubuntu system to run Radicle for decentralized Git collaboration.
## 1. Install Dependencies
```bash
sudo apt update && sudo apt install -y curl gnupg unzip git
2. Install Radicle CLI
curl -LO https://radicle.xyz/install.sh
chmod +x install.sh
./install.sh
3. Confirm Installation
rad --version
Expected output: rad 0.6.x
4. Generate a Radicle Identity
rad self
This will create a new cryptographic identity if none exists.
5. (Optional) Ensure Git Identity Is Set
git config --global user.name "Mark Randall Havens"
git config --global user.email "mark.r.havens@gmail.com"
---
### `2_create_remote_repo_radicle_ubuntu.md`
```markdown
# Create Remote Radicle Repo (Ubuntu)
Use this to convert your local Git repo into a Radicle project and push it to the decentralized network.
## 1. Navigate to Project
```bash
cd ~/fieldcraft/git-sigil
2. Initialize Radicle Project
rad init --name git-sigil --description "Decentralized fieldcraft publishing system."
3. List Registered Projects
rad projects
You should see git-sigil listed.
4. Push to Radicle Network
rad push
This distributes your repo across Radicle's peer-to-peer graph.
5. Copy the Radicle Project ID
rad self
Look for the project ID and store it somewhere secure.
---
### `3_commit_existing_repo_radicle_ubuntu.md`
```markdown
# Commit & Sync Changes in Radicle (Ubuntu)
This guide walks you through committing code and pushing it to the Radicle network.
## 1. Make a Change
Edit your files as needed. For example:
```bash
echo "New insight" >> README.md
2. Stage and Commit with Git
git add README.md
git commit -m "Update: $(date '+%Y-%m-%d %H:%M:%S')"
3. Push to Radicle
rad push
This sends your latest Git commit to peers following the project.
---
### `CLI-ONLY_workflow_radicle_ubuntu.md`
```markdown
# CLI-Only Workflow: Radicle on Ubuntu
This guide enables you to manage a full Git + Radicle workflow from the terminal only.
## 1. Create Your Identity
```bash
rad self
First run will create and store your identity under ~/.radicle.
2. Initialize a Radicle Repo
rad init --name fieldkit --description "Decentralized devkit for recursive fieldworkers."
3. Edit Files and Commit Locally
nano README.md
git add README.md
git commit -m "Initial insight and setup"
4. Push to the Radicle Network
rad push
5. Share Project ID
rad self
Copy the project ID for collaborators to run:
rad clone <project-id>
6. Stay Synced
No additional steps required. Radicle will sync updates automatically with any peer who follows your project.
---
Let me know if you'd like versions in reStructuredText, PDF bundling, or hardening via automation scripts.