git.iko.soy/urbit.org
on master help sign in
links, guide styling, and guide enumeration
commit158577eb1d274e911b3647ddcd69d84894e44790 authorGordon <gordon@Space.local> dateMon 16 May 2022, 13:48 (4 years ago) parent762b261
8 files changed+40−31
compare with master
unifiedsplit
content/getting-started/cli.md+2−2 content/getting-started/desktop.md+8−5 content/getting-started/getting-around.md+5−5 content/getting-started/hosted.md+2−2 content/getting-started/installing-applications.md+4−4 content/getting-started/joining-groups.md+6−6 content/getting-started/server.md+7−7 styles/markdown.css+6
content/getting-started/cli.md+2−2
@@ -82,9 +82,9 @@ There are five kinds of Urbit IDs but to get started you only need to know about
8282
8383A planet name looks like `~sampel-palnet`.
8484
85−[Follow this guide](/getting-started/planet) if you have already acquired a planet.
85+[Follow this guide](/getting-started/) if you have already acquired a planet.
8686
87−[Find a planet to purchase](/getting-started#get-a-planet)
87+[Find a planet to purchase](/getting-started/get-planet)
8888
8989---
9090
content/getting-started/desktop.md+8−5
@@ -4,7 +4,7 @@ description = "Run Urbit locally as a desktop application"
44weight = 1
55+++
66
7−### Get Port
7+### 1. Get Port
88
99Port is a desktop GUI application that allows you to spin up, access, and manage your Urbit ships without any knowledge of the command line or Urbit binary.
1010
@@ -82,20 +82,23 @@ Or to install `snap` for your distribution, snapcraft provides [installation ins
8282}
8383</style>
8484
85−### Launch a comet
85+### 2. Boot a comet
8686
8787A comet serves as a temporary identity for the network. It works just fine for checking out the network, but to download applications and get the full functionality of Urbit ID you’ll need a to get a planet.
8888
89−Start Port and hit the **Start without an ID** button. It'll take a few minutes to spin up the new comet. Once that's finished, click **Launch Ship into Urbit** and you'll be on the network.
89+Start Port and hit the **Start without an ID** button. It'll take a few minutes to spin up the new comet.
9090
9191![](https://media.urbit.org/site/getting-started/getting-started-easy-1.png)
9292
93−<div className="bg-wall-100 p-4 rounded-xl" style="padding-bottom: 1rem;">
93+### 3. Launch your ship
94+
95+Once that's finished, click **Launch Ship into Urbit** and you'll be on the network.
96+
97+<div className="bg-wall-100 p-7 rounded-xl markdown-callout">
9498
9599**Want to combine the simplicity of Port with a permanent Urbit ID?**
96100
97101If you already have a planet, first get your keyfile.
98−
99102Start Port, click the **Boot a fresh ID** option. Give your ship a name, and in the **Shipname** field, enter your planet name, like `~sampel-palnet`. For the **Key File** field, browse to the keyfile, select it, and hit **Continue**.
100103
101104Port will boot your Urbit in a few minutes!
content/getting-started/getting-around.md+5−5
@@ -4,7 +4,7 @@ description = "Get around your urbit"
44weight = 4
55+++
66
7−### Get oriented
7+### 1. Get oriented
88
99After you've logged into your Urbit for the first time, you're officially an Urbiter! You've unlocked the entire Urbit network with your newly-minted ID — the key to your new digital life.
1010
@@ -16,7 +16,7 @@ Above those are buttons to view System Preferences and Help and Support and chec
1616
1717You'll likely want to focus on finding and joining new communities, which you can do with the **Groups** app. Click on the box to open the application.
1818
19−### Join a few groups with fellow Urbiters
19+### 2. Join a few groups with fellow Urbiters
2020
2121No two people will ever have the same experience on Urbit. That depends entirely on who you find and where they invite you to join them. But we can set you down a good path.
2222
@@ -32,7 +32,7 @@ Here are a few more useful groups to join:
3232- [`~middev/the-forge`](/groups/~middev/the-forge): A group for sharing, discussing, and discovering new Urbit applications.
3333- [`~hocwyn-tipwex/uqbar-event-horizon`](/groups/~hocwyn-tipwex/uqbar-event-horizon): A community around [Uqbar](https://uqbar.network), a company creating applications and experiences on top of Urbit — notably EScape, which is an alternative to the default Groups application for joining communities and messaging with other Urbiters.
3434
35−### Get more Urbit apps
35+### 3. Get more Urbit apps
3636
3737Groups are great, but Urbit goes way deeper with apps that are developed specifically for Urbit and use P2P networking for everything.
3838
@@ -48,7 +48,7 @@ Some popular apps to get things moving:
4848- [Studio](/applications/~tirrel/studio): Tools for making money on the Urbit network.
4949- [Wrdu](/applications/~magped-magped-rabsef-bicrym/wrdu): A Wordle clone.
5050
51−### Get help
51+### 4. Get help
5252
5353If you need help getting around Urbit, the best place to go is the official Urbit community: [`~bitbet-bolbel/urbit-community`](/groups/~bitbet-bolbel/urbit-community). Those in the Help channel are willing to troubleshoot or provide links to resources to help you get out of a jam.
5454
@@ -58,7 +58,7 @@ If you're having trouble with your planet or the hosting provider that's running
5858
5959And if you can't get through this guide and launch into Urbit, you may have luck with the [Urbit Live community](https://t.me/UrbitLiveGroup) on Telegram.
6060
61−### What's next?
61+### 5. What's next?
6262
6363You made it! You did the work and now have your Final Computer.
6464
content/getting-started/hosted.md+2−2
@@ -4,7 +4,7 @@ description = "Run Urbit on a managed service"
44weight = 3
55+++
66
7−### Select a hosting provider
7+### 1. Select a hosting provider
88
99Hosting providers can sell you a planet and manage the hosting for you for a regular fee. We recommend [Urbit Host](https://urbithost.com) (not directly affiliated with Urbit.org) for quickly acquiring a planet and the hosting required to make your Urbit experience accessible from anywhere.
1010
@@ -14,7 +14,7 @@ Two important points about hosting providers:
1414
1515- Urbit has portable data, so you should be able to work with a hosting provider to download all your data and boot up elsewhere if you choose to migrate or start self-hosting.
1616
17−### Log in
17+### 2. Log in
1818
1919The exact steps for logging into your Urbit will depend on your hosting provider's infrastructure and the flow they've developed. If you have questions about logging into your hosted Urbit ship, contact their support.
2020
content/getting-started/installing-applications.md+4−4
@@ -4,7 +4,7 @@ tag = "additional"
44weight = 3
55+++
66
7−## 1. Get on the network
7+### 1. Get on the network
88
99First, you’ll need to get on Urbit. You can quickly check out the network by [downloading the Port application](https://github.com/urbit/port) and booting up a comet–a temporary Urbit ID.
1010
@@ -12,13 +12,13 @@ For long-term use, you’ll want to get a permanent Urbit ID and consider a runn
1212
1313Read our [Getting Started guide](https://urbit.org/install) for details.
1414
15−## 2. Finding applications
15+### 2. Finding applications
1616
1717Urbit is still in its early stages, so you’ll need to join groups and browse around the network to discover new applications as they are being brought up.
1818
1919However, we can get started a simple app from Urbit developer [`~paldev`](/ids/~paldev).
2020
21−## 3. Search for a Developer
21+### 3. Search for a Developer
2222
2323Once you’re on the network, you’ll see and large tiled interface with a few applications installed and a search bar on the top of the page.
2424
@@ -30,7 +30,7 @@ For example, to install the picture application, search for `~paldev` and then c
3030
3131![](https://media.urbit.org/site/application/app-guide2.png)
3232
33−## 4. Get the Application
33+### 4. Get the Application
3434
3535After selecting the “picture” app, a pane will open that shows some information about the application. Go ahead and click the “Get App” button, and confirm the following modal window to begin the installation process.
3636
content/getting-started/joining-groups.md+6−6
@@ -4,7 +4,7 @@ tag = "additional"
44weight = 2
55+++
66
7−## 1. Get on the network
7+### 1. Get on the network
88
99First, you’ll need to get on Urbit. You can quickly check out the network by [downloading the Port application](https://github.com/urbit/port) and booting up a comet–a temporary Urbit ID.
1010
@@ -12,13 +12,13 @@ For long-term use, you’ll want to get a permanent Urbit ID and consider a runn
1212
1313Read our [Getting Started guide](https://urbit.org/install) for details.
1414
15−## 2. Open the Groups app
15+### 2. Open the Groups app
1616
1717Once you’re on the network, you’ll see and large tiled interface with a few applications installed: Terminal, Groups, and Bitcoin. Click on Groups.
1818
1919![](https://media.urbit.org/site/group/groups-guide1.png)
2020
21−## 3. Enter the group shortcode
21+### 3. Enter the group shortcode
2222
2323We’ll start by joining Urbit Community, a friendly introductory Urbit group.
2424
@@ -29,7 +29,7 @@ Then confirm by clicking with the second “Join Group” button.
2929![](https://media.urbit.org/site/group/groups-guide2.png)
3030![](https://media.urbit.org/site/group/groups-guide3.png)
3131
32−## 4. Confirm join
32+### 4. Confirm join
3333
3434You should see a window that provides a description and group information. If not, check the spelling of the group name and address and try again.
3535
@@ -39,7 +39,7 @@ Click "Join Urbit Community".
3939
4040![](https://media.urbit.org/site/group/groups-guide4.png)
4141
42−## 5. Join channels
42+### 5. Join channels
4343
4444Congratulations, if you’re seeing a window like the one that appears below then you’ve joined the group!
4545
@@ -50,6 +50,6 @@ To join a channel within the group, select a channel name from the left column,
5050![](https://media.urbit.org/site/group/groups-guide5.png)
5151![](https://media.urbit.org/site/group/groups-guide6.png)
5252
53−## 6. Chat and post on the network
53+### 6. Chat and post on the network
5454
5555Congratulations you’re now a part of a peer-to-peer Urbit group. Be friendly, be curious, and have fun.
content/getting-started/server.md+7−7
@@ -4,7 +4,7 @@ description = "Run urbit on a local or cloud server"
44weight = 2
55+++
66
7−### Get yourself a planet
7+### 1. Get yourself a planet
88
99Here's some of the hard fun work we talked about earlier.
1010
@@ -18,7 +18,7 @@ Visit the instructions for [launching a temporary comet with Port](/getting-star
1818
1919There are many markets and individuals selling planets such as [azimuth.shop](https://azimuth.shop), [Networked Subject](https://subject.network), and [Wexpert Systems](https://wexpert.systems) for Ethereum, Bitcoin, and USD respectively.
2020
21−<div className="bg-wall-100 p-4 rounded-xl" style="padding-bottom: 1rem;">
21+<div className="bg-wall-100 p-7 rounded-xl markdown-callout">
2222
2323**Layer 1 vs Layer 2 planet purchasing**
2424
@@ -28,7 +28,7 @@ For this reason we generally advise using a L2 planet market, unless you are int
2828
2929</div>
3030
31−### Claim your planet
31+### 2. Claim your planet
3232
3333An invitation to claim your planet comes in one of two forms.
3434
@@ -40,7 +40,7 @@ The second, only recently made available through our [L2 solution](/getting-star
4040
4141Clicking a link to activate a planet on Bridge will take you to page which will generate a Master Ticket for you. Follow the instructions which will prompt you to download a copy of your Passport - your Master Ticket, management proxy, and keyfile. Store your Master Ticket and management proxy somewhere safe, hold on to the keyfile, and proceed to the next step.
4242
43−<div className="bg-wall-100 p-4 rounded-xl" style="padding-bottom: 1rem;">
43+<div className="bg-wall-100 p-7 rounded-xl markdown-callout">
4444
4545**Claiming L1 planets**
4646
@@ -48,7 +48,7 @@ If you’ve purchased an L1 planet, you won’t need to claim it because you alr
4848
4949</div>
5050
51−### Use Bridge to get your keyfile
51+### 3. Use Bridge to get your keyfile
5252
5353Now that you have your planet, you can create your keyfile (eg. `sample-palnet.key`), which is the cryptographic signature required to encrypt and decrypt messages on Urbit's P2P network.
5454
@@ -138,7 +138,7 @@ Arvo, the Urbit OS, now creates a directory called `sampel-palnet/` and begins b
138138
139139Welcome to Urbit! You can skip ahead to [log in](#log-in), or stick around for some tips.
140140
141−### Tips
141+### 4. Tips
142142
143143Check out the [cloud hosting guide](/using/running/hosting) for tips on improving the environment for Urbit, with a particular focus on establishing your domain name and using SSL for encryption.
144144
@@ -154,7 +154,7 @@ You should also delete your keyfile from your remote system to prevent yourself
154154rm ./your-keyfile.key
155155```
156156
157−### Log in
157+### 5. Log in
158158
159159First, use your browser to navigate to the URL+port where your ship is running. This could be an IP address or a fully-qualified domain name, depending on how you set yours up.
160160
styles/markdown.css+6
@@ -39,6 +39,12 @@
3939 @apply text-base md:text-lg leading-relaxed;
4040}
4141
42+.markdown-callout p {
43+ @apply mt-1;
44+ @apply mb-2;
45+ font-size: 1rem;
46+}
47+
4248.markdown li {
4349 @apply py-2 ml-6 text-base md:text-lg;
4450}