Skip to content

Add Japanese translations and initial multilingual structure #24

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
newt0 wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Add Japanese translations and initial multilingual structure #24

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8ab6fa8
add: initial translation directory structure
newt0 Jul 24, 2025
cb19a5b
add: Claude prompt for Japanese translation
newt0 Jul 24, 2025
14d423f
add: completed Japanese translations of all existing GitHub articles
newt0 Jul 24, 2025
926dbb6
add: translated all non-GitHub articles into Japanese after convertin…
newt0 Jul 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
146 changes: 146 additions & 0 deletions content/guest-articles/build-permaweb-site-with-ario.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,146 @@
![ARIO Header](https://permaweb-journal.arweave.net/static/images/ario-header.png)

## Introduction: What Is AR.IO?

AR.IO is the world’s first permanent cloud network, built on the Arweave storage protocol and AO compute layer. It offers decentralized, tamper-proof, and universally accessible data storage, ensuring that data, applications, and digital identities remain timeless, secure and accessible everywhere. AR.IO connects users to the permaweb — a web where information lives forever, free from centralized control.

The AR.IO Network is open, distributed, and ownerless.The network runs on decentralized nodes called AR.IO Gateways, which serve as permanent cloud service providers capable of reading, writing, indexing, and querying data stored on the permaweb.These gateways provide a consistent and reliable interface for accessing permanent data, domain name services (ArNS), and applications, all through lasting web addresses.

Powered by the ARIO utility token, the network enables domain registration through the Arweave Name System (ArNs), supports staking, and rewards gateway operators–thereby creating strong incentives for participation. Together, these elements form the backbone of a permanent cloud network built to preserve data and expand the web’s possibilities.

## Why Traditional Websites Don’t Last – and Why They Fall Short for Small Businesses

Small businesses rely on websites to connect with customers. But traditional hosting and domains are fragile and risky:

- Domain expiration: Domains are leased yearly. Missed payments can cause loss of your website address to competitors or squatters. Over 30% of small businesses experience unintended domain lapses within five years, losing traffic and trust.
- Recurring hosting costs: Monthly or annual fees add up, straining budgets. Hosting providers may shut down or delete sites for non-payment, payment issues or outages, causing sudden downtime.
- Consequences: Lost customer trust, vanished SEO rankings, broken brand identity, and costly recovery efforts. “Maria’s bakery lost its website and customer data when her hosting provider shut down during a payment dispute.” This is a common story and risk for many small businesses.

## AR.IO’s Solution to the problem: Hosting That’s Permanent, Decentralized, and Affordable

AR.IO leverages Arweave and AO to offer:

- One-time payment: Pay once to register your domain, own it permanently and host your website forever. No renewals, no hidden fees.
- Permanent domains: ArNS lets you own domains like mariasbakery.ar outright, with no renewals and no risk of expiration .
- Tamper-proof storage: Data is immutable,stored forever and distributed across global nodes(decentralized nodes), ensuring 100% uptime and protection from censorship or deletion.
- Easy management: No Coding required, with no-code builders and simple upload interfaces. This decentralized approach reduces costs, increases reliability, and simplifies management.

![ARIO](https://permaweb-journal.arweave.net/static/images/ario1.png)

## What This Guide Covers

This guide walks you through four easy phases to build and maintain your permanent website on AR.IO:

1. Register your permanent domain via ArNS
2. Build your website with no-code tools
3. Upload your website to AR.IO’s decentralized gateway
4. Update your website content anytime

![ARIO](https://permaweb-journal.arweave.net/static/images/ario2.png)

**Visual Representation: Workflow Diagram** “A Step-by-Step linear workflow for creating and maintaining a permanent website on AR.IO. Each phase builds on the previous, ensuring seamless integration.”

### Step 1: Register Your Business Domain on AR.IO

Your domain is your permanent address on the permaweb.

1. Visit the AR.IO Domain Portal.
2. Search for your desired name (e.g., mariasbakery).
3. Check availability and validity (6–51 characters, no leading/trailing hyphens).
4. Choose to buy outright or lease (1–5 years). Buying is one-time payment.
5. Connect your Arweave wallet (e.g., Wander formerly ArConnect) or pay with credit card.
6. Confirm the transaction and wait 1–2 minutes for blockchain verification. Tips:

- Keep your domain short and brand-aligned.
- Register common misspellings to protect your brand.

Example: Maria bought mariasbakery.ar for $50 with a credit card—no renewals needed.

This images below gives a graphic view so you can understand much more even as you visit the website. ![Bazar HyperBEAM Header](https://permaweb-journal.arweave.net/static/images/ario3.png) ![Bazar HyperBEAM Header](https://permaweb-journal.arweave.net/static/images/ario4.png)

### Step 2: Build Your Website Without Coding

Use simple tools and website builders to create your site.

**Google Sites (Free, Multi-Page)**

- Design your site at Google Sites.
- Export your site as static files using tools like HTTrack or SiteSucker.

![Bazar HyperBEAM Header](https://permaweb-journal.arweave.net/static/images/ario5.png)

**Carrd.co (Affordable, Single-Page)**

- Build a sleek site at Carrd.co for $19/year.
- Export your site as ZIP containing HTML, CSS, and JS files.

![Bazar HyperBEAM Header](https://permaweb-journal.arweave.net/static/images/ario6.png)

**Starter Template** We provide a simple starter template to jumpstart your site: [GitHub: AR.IO Small Business Starter Template](https://github.com/IsiomaLight/ar-io-smallbiz-template/) Includes homepage, contact form, and image gallery with easy customization.

### Step 3: Upload Your Website to the Permaweb and Create a Manifest (Using Maria’s Bakery as an Example)

Make your website permanent and accessible.

- **Organize your website files**: Maria gathers all her bakery website files—index.html (homepage), other HTML pages, CSS, images of her cakes, and JavaScript—into a folder called marias-bakery-site.
- \*\*Go to [ArDrive Web App](https://ardrive.ar.io/) \*\*: Maria opens ArDrive in her browser and logs in using Wander (previously ArConnect).
- **Create or open a public drive**: She clicks “New” → “New Drive”, names it “Maria’s Bakery Website,” and sets it to Public.
- **Upload her website folder**: Inside her public drive, Maria clicks “Upload” → “Upload Folder”, selects her marias-bakery-site folder, ensures “Public” is checked, and clicks “Upload.” She approves the AR token payment in Wander.
- **Create a manifest file**: After uploading, Maria clicks the red +New button and selects Advanced → New Manifest. She chooses the same folder as her index.html file, names the manifest (e.g., “permasite”, “mariasbakery”), and confirms. She approves the transaction in Wander. The manifest icon will appear yellow while it’s being confirmed. When it turns green, her permasite is live!
- **Preview and copy the manifest TXID**: Maria clicks the manifest file, uses the Preview icon to open her site in a new tab, and tests all pages and navigation. She then copies the manifest’s Data TX ID—this is the permanent reference she’ll use for her domain.

**Note**: When previewing from the manifest, Maria will see a long, random-looking URL. Once she links her ArNS domain, her site will be available at her chosen human-readable address (e.g., mariasbakery.ar.io). Visitors will only need to use this clean domain, not the long TXID URL.

### Step 4: Link Your Domain with ArNS (.ar Domain)

Connect your permanent website to your official AR.IO domain (e.g., mariasbakery.ar).

- **Go to ArNS App**: Log in using Wander (previously ArConnect).
- **Manage your .ar domain**: Find your domain (e.g., mariasbakery.ar) under “Manage” and click “Edit.”
- **Update your domain’s target**: In the “Target ID” field, paste the manifest TXID you copied from ArDrive. Click “Save” and approve the transaction (uses a small amount of tokens).
- **Test your domain**: After a few minutes, visit your website (e.g., [https://mariasbakery.ar](https://mariasbakery.ar/) or [https://mariasbakery.ar.io](https://mariasbakery.ar.io/)) in your browser. Your website should now load at your official AR.IO domain, and you can see your live site!

**Note**: When previewing from the manifest, you’ll see a long, random-looking URL. Once you link your ArNS domain, your site will be available at your chosen human-readable address (e.g., mariasbakery.ar.io).

**Best Practices**:

- Backup all versions (e.g., bakery_v1.zip , bakery_v2.zip).
- Track transaction IDs in a spreadsheet for easy reference.
- Test locally before uploading.

“e.g Maria adds a seasonal holiday menu by editing her Carrd.co file, re-uploading it, and updating her domain’s pointer.”

## Understanding the Technology: Arweave, AO, and AR.IO

- **Arweave** is a novel blockchain-like protocol called a blockweave. It stores data permanently by linking each new block to a previous random block, incentivizing miners to store all data securely and efficiently.
- **AO (Actor Oriented)** is a decentralized compute layer on Arweave, enabling smart contracts and decentralized applications. AR.IO operates on AO, leveraging its compute and storage capabilities.
- **AR.IO** builds on Arweave and AO to provide user-friendly gateways, domain services (ArNS), and token incentives (ARIO) for a permanent web ecosystem.

## Final Thoughts

AR.IO empowers small businesses to own their online presence forever—secure, affordable, and easy to manage. Maria’s Bakery now has a website that won’t disappear, saving money and preserving customer trust.

**Ready to start?**

- Register your domain at [AR.IO](https://ar.io/)
- Build your site with no-code tools
- Upload and link your site for permanent hosting

Your website should last as long as your business does.

Ishioma Light is a writer and community builder focusing on Web3 tech, growing, scaling, sustaining and influencing communities with strategy, content, engagement, incentives and community building. Follow Ishioma on [X](https://x.com/HorizonXBT) and [Linkedin](https://www.linkedin.com/in/ishioma-light-41786a234/).

---

**Disclosure:** This is a guest post submitted by an external contributor. The views expressed are their own and do not necessarily reflect those of Permaweb Journal.

---

## Resources

- [AR.IO](https://permaweb-journal.arweave.net/projects/ar-io.html)

## Further Reading

- [Permaweb Index](https://permaweb-journal.arweave.net/article/permaweb-index.html)
- [HyperBEAM Milestone 3 Update](https://permaweb-journal.arweave.net/article/hyperbeam-milestone-3-beta.html)
139 changes: 139 additions & 0 deletions content/guest-articles/learn-the-permaweb-with-permamind.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,139 @@
## Learn the Permaweb with Permamind \[Guest Post\]

Jul 08, 20254 min read

![Permamind Header](https://permaweb-journal.arweave.net/static/images/permamind-header.png)

## Introduction

- **What is Permamind?**
- While Permamind is the world’s first permanent, decentralized AI memory system built on Arweave and AO, this guide focuses on its power as your personal, always-current documentation assistant for the Permaweb ecosystem
- It’s pre-loaded with the latest official documentation (`AO Cookbook`, `HyperBEAM`, etc.) and acts as an informed LLM that can answer complex technical questions accurately
- Think of it as having a Permaweb expert available 24/7 who never gives outdated or hallucinated answers
- **What This Guide Covers**
- This post will walk you through the entire setup process, from installing the server to connecting your favorite AI client and running your first query
- We will provide specific instructions for **Claude Desktop**, **Cursor**, and **Raycast**
- **Why This Matters**
- Instead of digging through multiple docs or getting generic/outdated responses from standard LLMs, you’ll have instant access to accurate, current information about the Permaweb tech stack
- Perfect for developers building on AO, learning the Permaweb, or beginning their journey with HyperBEAM

## Part 1: Installing the Permamind Server

### Prerequisites

- You’ll need `Node.js` version 20 or higher. You can check your version by running:

```bash
node -v
```

### Installation Steps

- To install permamind, open your terminal and use npm to install the Permamind package globally.

```bash
npm i -g permamind
```

## **Part 2: Connecting Your AI Client**

Now that your local Permamind server is running, let’s connect it to your AI-powered development tool.

### Claude Desktop

1. **Locate your Claude Desktop config file**:

- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

2. **Add the Permamind server configuration**: Open the config file and add the following MCP server configuration:

```json
{
"mcpServers": {
"Permamind": {
"command": "npx",
"args": ["permamind"]
}
}
}
```

3. **Restart Claude Desktop** for the changes to take effect.
4. **Verify the connection**: You should see the Permamind server listed in your available tools/servers within Claude Desktop.

### Cursor

1. Open your Cursor editor.
2. Go to `Cursor Settings` > `Tools & Integrations`.
3. Click `New MCP server`.
4. Add the following configuration:

```json
{
"mcpServers": {
"Permamind": {
"command": "npx",
"args": ["permamind"]
}
}
}
```

5. Save the configuration and restart Cursor for the changes to take effect.

### Raycast

1. Open Raycast and search for “MCP” or navigate to AI settings.
2. Search for **Install MCP Server**.
3. Fill in the configuration form:

| Field | Value |
| --------------- | --------------------------------- |
| **Transport** | Select `Standard Input/Output` |
| **Command** | Enter `npx` |
| **Arguments** | Enter `permamind` |
| **Description** | Custom description of this server |

4. **Cmd** + **Return** to install the server.
5. Invoke the MCP server using `@permamind <Your query here>`

## Part 3: A Sample Run

Let’s confirm everything is working. The Permamind server you’re running has been pre-configured with the latest documentation for AO, the Permaweb Cookbook, HyperBEAM, and more.

### The Prompt

In your configured client (Claude, Cursor, or Raycast), start a new chat and ask a question that requires knowledge of the AO ecosystem.

**For example**:

- What is HyperBEAM?
- How can I expose my AO process to HyperBEAM?
- How can I use AR.IO’s Wayfinder SDK?

### Expected Output

Your AI client should provide a detailed, accurate answer based on the official documentation. It won’t give a generic or hallucinated response because Permamind is feeding it the correct context.

**Example** ![Expose AO Process](https://hackmd.io/_uploads/SkIxNe9rel.png)

### How does it work?

Your client sent the prompt to your local Permamind server. The server identified the topic and used the integrated Permaweb docs to provide the LLM with the necessary information to form a correct response.

## **Conclusion & Next Steps**

Congratulations! You now have a personal, always-current permaweb assistant running locally. You’ve successfully installed the server, connected a client, and verified its ability to provide accurate, up-to-date answers using our ecosystem’s official documentation.

This is a huge boost to your development workflow, enabling you to learn, build, and debug with Permaweb technologies faster than ever - no more outdated answers or generic LLM responses when working with AO, HyperBEAM, or any part of the Permaweb.

Dylan Shade is a software developer at Forward Research. Follow Dylan on [X](https://x.com/dpshade22).

Jonathon Green is a software developer exploring the Arweave/AO ecosystem. Follow Jonathan on [X](https://x.com/ALLiDoizCode).

---

**Disclosure:** This is a guest post submitted by external contributors. The views expressed are their own and do not necessarily reflect those of Permaweb Journal.

---
Loading