funcool / funcool/clojurescript-unraveled

Building on macOS Mojave

Open
#153 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
XSLT
Stars
479
Forks
53
PR merge metrics
No merged PRs in 30d

Description

Just wanted to share how I got the HTML to build on macOS Mojave 10.4.5.

Dependencies:

* ruby 2.3.8 (I used [asdf-ruby](https://github.com/asdf-vm/asdf-ruby) to install it then [set the asdf ruby version locally](https://asdf-vm.com/#/core-manage-versions?id=set-current-version))
* python 2.7.16 (I used [asdf-python](https://github.com/danhper/asdf-python) to install it then [set the asdf python version locally](https://asdf-vm.com/#/core-manage-versions?id=set-current-version))
* pygments.rb 0.6.3 (`gem install pygments.rb -v 0.6.3`)
* asciidoctor 1.5.4 (`gem install asciidoctor -v 1.5.4`)

Then use `make html`. To get the HTML to look right I had to move `dist/index.html` to the root of the git checkout and then open it (so `./assets/*` and `./images/*` could be found by the browser).

(**NOTE**: It might pay for the Makefile to copy `./assets` and `./images` into `./dist` for the `html` target.)

Contributor guide

No contributing guide indexed for this repository

Research direction

Read the Makefile and the existing build documentation, then run `make html` using the dependency versions listed in the issue. Check whether the generated HTML can locate `assets` and `images` from `dist`; done means the macOS build instructions or build behavior clearly support opening the generated HTML.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos, python, ruby
Domain
build-system, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.