CSC4102-2024-Installation-Guide-Mac-OSX
SSH
To check if ssh is installed on your Mac:
$ which ssh
/usr/bin/ssh
If not already installed, we recommend using OpenSHH from https://www.openbsd.org/openssh/
Installation on a mac is simple if you already have a package manager,eg:
- Homebrew
brew install openssh
(see https://formulae.brew.sh/formula/openssh) - Macports - is a more complicated package manager to install (see https://guide.macports.org ) but can also be used to install marktext.
sudo port install openssh
A zipped package can also be downloaded from the macupdate site - https://download.macupdate.com/app/mac/5675/openssh/download
GIT
There are several ways to install Git on macOS. The easiest is probably to install the Xcode Command Line Tools. You can do this simply by trying to rungit
from the Terminal the very first time.
$ git --version
You should see something like:
git version 2.39.5 (Apple Git-154)
If you don’t have it installed already, it will prompt you to install it.
You can also install it using a package manager,eg:
- Homebrew
brew install git
(see [https://formulae.brew.sh/formula/git) - Macports - is a more complicated package manager to install (see https://guide.macports.org ) but can also be used to install marktext.
sudo port install git
Markdown Editor/Viewer - Mark Text
The recommended viewer on macOS X is "Mark Text (marktext)". The source code is availabe on gitub - https://github.com/marktext/marktext and the build works for Linux, macOS and Windows.
Installation on a mac is simple if you already have a package manager,eg:
- Homebrew
brew install --cask mark-text
(see https://formulae.brew.sh/cask/mark-text) - Macports - is a more complicated package manager to install (see https://guide.macports.org ) but can also be used to install marktext.
sudo port install marktext
A zipped package can also be downloaded from the macupdate site - https://www.macupdate.com/app/mac/63668/mark-text
When using the editor, you can toggle the view "source code mode" to switch between editing the source and viewing the result.
PlantUML
As well as installing PlantUML as an Eclipse plug-in, you can install it as a standalone application.
Installation with a package manager is simple:
- Homebrew
brew install plantuml
- MacPorts -
sudo port install plantuml
Note: It depends on Java (the minimum version needed is Java 8)and graphviz already being installed. (See https://medium.com/@miniChang8/install-plantuml-on-mac-93e445842445)
A compiled jar can also be downloaded from https://plantuml.com/download?utm_content=cmp-true
Guidelines for running the application can be found at - https://plantuml.com/starting
You can either :
- run on the commmand line -
java -jar plantuml.jar UML-Diagram.txt
- run the GUI -
java -jar plantuml.jar -gui
where,plantuml.jar
is the name of the jar file you downloaded previously.