191 lines
3.3 KiB
Markdown
Executable file
191 lines
3.3 KiB
Markdown
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`
|
|
|
|
````markdown
|
|
# 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
|
|
|
|
```bash
|
|
curl -LO https://radicle.xyz/install.sh
|
|
chmod +x install.sh
|
|
./install.sh
|
|
```
|
|
|
|
## 3. Confirm Installation
|
|
|
|
```bash
|
|
rad --version
|
|
```
|
|
|
|
Expected output: `rad 0.6.x`
|
|
|
|
## 4. Generate a Radicle Identity
|
|
|
|
```bash
|
|
rad self
|
|
```
|
|
|
|
This will create a new cryptographic identity if none exists.
|
|
|
|
## 5. (Optional) Ensure Git Identity Is Set
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
rad init --name git-sigil --description "Decentralized fieldcraft publishing system."
|
|
```
|
|
|
|
## 3. List Registered Projects
|
|
|
|
```bash
|
|
rad projects
|
|
```
|
|
|
|
You should see `git-sigil` listed.
|
|
|
|
## 4. Push to Radicle Network
|
|
|
|
```bash
|
|
rad push
|
|
```
|
|
|
|
This distributes your repo across Radicle's peer-to-peer graph.
|
|
|
|
## 5. Copy the Radicle Project ID
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
git add README.md
|
|
git commit -m "Update: $(date '+%Y-%m-%d %H:%M:%S')"
|
|
```
|
|
|
|
## 3. Push to Radicle
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
rad init --name fieldkit --description "Decentralized devkit for recursive fieldworkers."
|
|
```
|
|
|
|
## 3. Edit Files and Commit Locally
|
|
|
|
```bash
|
|
nano README.md
|
|
git add README.md
|
|
git commit -m "Initial insight and setup"
|
|
```
|
|
|
|
## 4. Push to the Radicle Network
|
|
|
|
```bash
|
|
rad push
|
|
```
|
|
|
|
## 5. Share Project ID
|
|
|
|
```bash
|
|
rad self
|
|
```
|
|
|
|
Copy the project ID for collaborators to run:
|
|
|
|
```bash
|
|
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.
|
|
```
|
|
|