f906427 · urbit.org · git.iko.soy

git.iko.soy/urbit.org

fix broken links

commitf9064276dee87d9915b73476e835bd26aa16f821 authorMorgan Sutherland <morgan@morgansutherland.com> dateTue 21 May 2019, 17:47 (7 years ago) parentb456281

8 files changed+13−11

compare with master

unifiedsplit

concepts/galaxies-stars-and-planets.md+2−1 getting-started/booting-a-ship.md+1−1 getting-started/using-bridge.md+2−1 learn/hoon/hoon-tutorial/_index.md+1−1 reference/hoon-expressions/rune/mic.md+4−3 using/_index.md+1−2 using/admin.md+1−1 using/shell.md+1−1

concepts/galaxies-stars-and-planets.md+2−1

@@ -4,9 +4,10 @@ weight = 7

44template = "doc.html"

55description = "An explanation of the Urbit address-space hierarchy. "

66+++

78The current internet has no consistent system of identity. There are only quasi-identities such as IP addresses, Google accounts and email addresses, each able to be assumed and abandoned without much trouble. The result is a hostile social experience, since bad actors -- spammers, scammers, malware-spreaders, and harassers -- have an inexhaustible supply of places to hide.

9−That's why we built a system for persistent identity called [Azimuth](./docs/concepts/arvo-vs-azimuth.md). Azimuth identities are called _points_, and you need one to use the Arvo network. Points are secure, since they are owned and controlled with key-pair the Ethereum blockchain, which Azimuth is built on top of.

10+That's why we built a system for persistent identity called [Azimuth](./docs/concepts/azimuth.md). Azimuth identities are called _points_, and you need one to use the Arvo network. Points are secure, since they are owned and controlled with key-pair the Ethereum blockchain, which Azimuth is built on top of.

1011

1112An Azimuth point is a pronounceable string like `~firbyr-napbes`. It means nothing, but it's easy to remember and say out loud. `~firbyr-napbes` is actually just a 32-bit number (`3.237.967.392`, to be exact) that we turn into a human-memorable string.

1213

getting-started/booting-a-ship.md+1−1

@@ -3,7 +3,7 @@ title = "Booting a Ship"

33weight = 3

44template = "doc.html"

55+++

6−Now the rubber meets the road. You'll be booting your ship with the keyfile that you [downloaded from Bridge](./docs/concepts/azimuth/_index.md).

6+Now the rubber meets the road. You'll be booting your ship with the keyfile that you [downloaded from Bridge](./docs/concepts/azimuth.md).

88Note that this document is only for booting a ship that uses the live Arvo network. If you just want to create an unnetworked ship for development purposes, read [this guide](./docs/getting-started/creating-a-development-ship.md) instead.

getting-started/using-bridge.md+2−1

@@ -3,7 +3,8 @@ title = "Using Bridge"

33weight = 1

44template = "doc.html"

55+++

6−[Bridge](https://github.com/urbit/bridge) is the client we built for interacting with [Azimuth](./docs/concepts/azimuth/_index.md), the Urbit PKI, and managing your Azimuth identities, called _points_. Importantly, Bridge also allows you to generate a keyfile that you will need to boot your ship so that it can use the Arvo network.

7+[Bridge](https://github.com/urbit/bridge) is the client we built for interacting with [Azimuth](./docs/concepts/azimuth.md), the Urbit PKI, and managing your Azimuth identities, called _points_. Importantly, Bridge also allows you to generate a keyfile that you will need to boot your ship so that it can use the Arvo network.

89This guide assumes that you own an Azimuth point, or that you have found someone to send an Azimuth point to your Ethereum address and are looking to claim it.

910

learn/hoon/hoon-tutorial/_index.md+1−1

@@ -47,7 +47,7 @@ The first three lessons take you through a simple Hoon program, explain Hoon's s

4747

4848Consult the [Reference section](./docs/reference/_index.md) to look up any unknown rune or standard library function you don't understand.

4949

50−As you work your way through these lessons you may want to work on example problems from the [Hoon Workbook](./docs/learn/hoon/workbook/_index.md) for practice. Once you finish the lessons here you may want to write more versatile Hoon programs which can make use of more of your urbit's environment, in which case you'll want to check out the [Generators](./docs/using/generators.md) documentation. Or maybe you'd like to learn how to write a [Gall app](content/docs/learn/arvo/gall.md). Learn about [Udon](./docs/using/udon.md), Urbit's stripped-down version of Markdown. Or learn [Sail](./docs/using/sail.md), a subset of Hoon used for generating XML nodes.

50+As you work your way through these lessons you may want to work on example problems from the [Hoon Workbook](./docs/learn/hoon/workbook/_index.md) for practice. Once you finish the lessons here you may want to write more versatile Hoon programs which can make use of more of your urbit's environment, in which case you'll want to check out the [Generators](./docs/using/generators.md) documentation. Or maybe you'd like to learn how to write a [Gall app](content/docs/learn/arvo/gall.md). Learn about [Udon](./docs/using/sail-and-udon.md), Urbit's stripped-down version of Markdown. Or learn [Sail](./docs/using/sail-and-udon.md), a subset of Hoon used for generating XML nodes.

5151

5252

5353> Last major revision of this section: February 2019

reference/hoon-expressions/rune/mic.md+4−3

@@ -3,6 +3,7 @@ title = "Make"

33weight = 13

44template = "doc.html"

55+++

67Miscellaneous useful macros.

89## Runes

@@ -79,7 +80,7 @@ A `marl`, i.e., a list of `manx`. A `manx` is a noun that represents a single X

7980

8081tl;dr -- `;+` converts a `manx` to a `marl`.

8182

82−`;+` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail.md).

83+`;+` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail-and-udon.md).

8384

8485In Sail a single XML node is represented by a `manx`. A single `<p>` node `manx` can be produced in the following way:

8586

@@ -293,7 +294,7 @@ A `marl`, i.e., a list of `manx`. A `manx` is a noun that represents a single X

293294

294295##### Discussion

295296

296−`;*` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail.md).

297+`;*` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail-and-udon.md).

297298

298299If you need a complex Hoon expression to produce a `marl`, use the `;*` rune. Often this rune is used with an expression, `p`, that includes one or more `;=` subexpressions.

299300

@@ -345,7 +346,7 @@ A `marl`, i.e., a list of `manx`. A `manx` is a noun that represents a single X

345346

346347##### Discussion

347348

348−`;=` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail.md).

349+`;=` is a Sail rune. Sail is a part of Hoon used for creating and operating on nouns that represent XML nodes. With the appropriate rendering pipeline, a Sail document can be used to generate a static website. See the [Sail tutorial](./docs/using/sail-and-udon.md).

349350

350351In Sail a single XML node is represented by a `manx`. A single `<p>` node `manx` can be produced in the following way:

351352

using/_index.md+1−2

@@ -11,6 +11,5 @@ This section contains guides to using your urbit.

1111- [Shell](./docs/using/shell.md) is a guide to using Dojo, our command-line interface.

1212- [Introduction to the Filesystem](./docs/using/filesystem.md) explains the basics of using use Clay, our revision-control filesystem.

1313- [Source Layout](./docs/using/layout.md) walks you through the various directories of the Arvo operating system.

14−- [Sail](./docs/using/sail.md) is a guide to Sail: Hoon markup that's used to build web pages with XML.

15−- [Udon](./docs/using/udon.md) is a guide to Udon, which is our take on Markdown.

14+- [Sail and Udon](./docs/using/sail-and-udon.md) is a guide to Sail: Hoon markup that's used to build web pages with XML and Udon, which is our take on Markdown.

1615- [Generators](./docs/using/generators.md) will explain how to use the "generator," a kind of file that's the easiest way to run Hoon programs.

using/admin.md+1−1

@@ -164,7 +164,7 @@ moon: ~faswep-navred-sampel-palnet

164164and does not need editing to be used with the `-k` option.

165165

166166You can use the resulting output in the same installation flow from the

167−[Booting a Ship](./docs/getting-started/booting-a-ship/) guide, following the same scheme as for booting a planet. That scheme is:

167+[Booting a Ship](./docs/getting-started/booting-a-ship.md) guide, following the same scheme as for booting a planet. That scheme is:

168168

169169```

170170$ urbit -w <moonname> -G <key> -c <piername>

using/shell.md+1−1

@@ -256,7 +256,7 @@ Apps usually expect marked data, so `&` is often used here.

256256

257257##### `*` - Save in `%clay`

258258

259−Save a new `.udon` ([Udon](./docs/using/udon.md)) file in `web`:

259+Save a new `.udon` ([Udon](./docs/using/sail-and-udon.md)) file in `web`:

260260

261261```

262262~your-urbit:dojo> *%/web/foo/udon '# hello'