맥OS에서 spark/docs 빌드하기
4 min readAug 5, 2016
HTML docs 와 API docs 를 Scala, Python 그리고 R에서 빌드하려면 몇 가지 도구들을 설치해야 한다.
참고) 현재 2016–08–05 문서대로 진행해도 API Docs 빌드 시 에러 발생 … 미해결.
1. 루비와 파이썬 설치
sudo gem install jekyll jekyll-redirect-from pygments.rb
sudo easy_install pip
sudo pip install sphinx
2. R 설치
위 링크의 동영상을 참고하여 R을 설치하고 아래 명령을 실행한다.
sudo Rscript -e 'install.packages(c("knitr", "devtools", "roxygen2", "testthat"), repos="http://cran.stat.ucla.edu/")'
3. github에서 spark 포크, 체크아웃
https://github.com/oopchoi/spark-docs
우선 위 링크의 레파지토리를 자신의 원격 레파지토리로 복사(Fork) 한다.
자신의 원격 레파지토리에서 로컬 저장소로 복사(Clone) 한다.
Clone 주소를 클립보드로 복사 한 후 인텔리제이를 실행하고 클론한다.
4. HTML 생성
체크아웃 받은 spark 경로 아래 docs 폴더로 이동해서 아래 명령을 실행한다.
jekyll build
빌드 할 때 다음과 같이 할 수도 있다.
# Skip generating API docs (which takes a while)
$ SKIP_API=1 jekyll build
# Serve content locally on port 4000
$ jekyll serve --watch
# Build the site with extra features used on the live page
$ PRODUCTION=1 jekyll build
첫 번째, API docs는 생성하지 않도록 빌드
두 번째, 4000 포트로 로컬에서 접속 가능하도록 빌드
세 번째, 사이트의 부가 기능으로 페이지를 제공하도록 빌드
자 .. 이제 html 생성하는 방법을 알았으니 열심히 번역이나 해볼까!!!