summaryrefslogtreecommitdiff
path: root/docs/modules/install/pages/macos.adoc
blob: 0fd2c8f7cd8595064b90983a0a13c4ab2a41b670 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
= Install on macOS
:url-homebrew: https://brew.sh
:url-macports: https://www.macports.org
:url-install-macports: https://www.macports.org/install.php
:url-asciidoctor-port: https://ports.macports.org/port/asciidoctor/

== Homebrew

=== Install

You can use {url-homebrew}[Homebrew^], the macOS package manager, to install Asciidoctor.
If you don't have Homebrew on your computer, complete the {url-homebrew}[installation instructions^] first.

Once Homebrew is installed, you're ready to install the `asciidoctor` gem.
Open a terminal and type:

 $ brew install asciidoctor

Homebrew installs the `asciidoctor` gem into an exclusive prefix that's independent of system gems.

include::partial$success.adoc[]

=== Upgrade

To upgrade the gem, open a terminal and type:

 $ brew update
 $ brew upgrade asciidoctor

=== Uninstall

To uninstall the gem, open a terminal and type:

 $ brew uninstall asciidoctor

== MacPorts

You can also use {url-macports}[MacPorts^], another package manager for macOS, to install Asciidoctor.
If you don't have MacPorts on your computer, complete the {url-install-macports}[installation instructions^] first.

Once MacPorts is installed, you're ready to install the `asciidoctor` gem via the {url-asciidoctor-port}[Asciidoctor port^].
Open a terminal and type:

 $ sudo port install asciidoctor

include::partial$success.adoc[]

=== Upgrade

To upgrade the gem, open a terminal and type:

 $ sudo port selfupdate
 $ sudo port upgrade asciidoctor

=== Uninstall

To uninstall the gem, open a terminal and type:

 $ sudo port uninstall asciidoctor