모바일 환경에서 깃허브 블로그 관리하기

February 28, 2024 4 minute read

Ruby와 Jekyll을 설치하면 로컬 PC 환경에서 서버를 구동하여 깃허브 블로그가 어떻게 렌더링될지 확인할 수 있습니다. 이런 환경을 노트 PC에 구축해 둔다면 어디서든 자유롭게 포스트를 수정하고 레포지토리에 push할 수 있겠지만, 여의치 않다면 태블릿이나 스마트폰 등 모바일 환경을 활용하고 싶다는 생각이 들 수 있습니다. 안드로이드 태블릿(갤럭시 노트 10+ 및 갤럭시 탭 7 FE)에서 Jekyll 정적 블로그를 로컬 빌드하기 위해 필요했던 내용들을 아래에 정리합니다.

1. F-Droid 앱 스토어 및 Termux 설치

모바일 환경에서 리눅스 터미널을 이용하기 위해 Termux를 설치해야 합니다. Termux는 구글 플레이스토어에서도 검색할 수 있는 어플리케이션이지만, 이것을 다운로드하면 안 되고 F-Droid라는 오픈소스 어플리케이션 스토어에서 다운로드해야 합니다.

F-Droid 설치 (다운로드 페이지)
F-Droid를 실행하고 Termux를 검색하여, Termux Terminal emulator with packages를 설치

2. Termux 설정

Termux를 실행하고, 아래 명령으로 Termux가 태블릿의 로컬 저장소에 대한 접근 권한을 갖도록 해 줍니다.

1
termux-setup-storage

3. git 설치 및 설정

3.1. git 설치 및 설정

Termux 터미널에서 git을 설치합니다.

1
pkg install git

태블릿에서 사용할 git 유저네임 및 이메일 주소를 설정합니다.

        
git config --global user.name 'Hong Gil Dong'
git config --global user.email 'honggildong@example.com'

3.2. SSH Key 생성 및 Github 레포지토리에 등록

깃허브 원격 저장소를 클론하기 위해 HTTPS 주소 방식이나 SSH 주소 방식을 사용할 수 있습니다. HTTPS 주소 방식을 사용하기로 하면 이 과정은 진행할 필요가 없지만, 변경사항을 원격 저장소에 푸시할 때마다 깃허브 사용자 이름과 비밀번호를 매번 입력해 주어야 합니다. SSH 방식을 사용하면 터미널에서 최초 1회 SSH 연결을 진행할 때를 제외하면 별도의 자격증명 없이 변경 사항을 계속 푸시할 수 있어 편리합니다.

Termux 터미널에서 현재 모바일 기기의 SSH 키를 생성 (참고)

        
      
#openssh 패키지 설치
pkg install openssh
ssh-keygen -t ed25519 -C <클론해 올 레포지토리에 등록된 이메일 주소>
cat ~/.ssh/id_ed25519.pub
#cat 명령으로 출력되는 키 값을 Ctrl+C로 복사

./ssh/config 파일 설정

./ssh/config 파일을 생성하거나 아래 내용이 포함되도록 수정합니다.

1
2
3
4
5
6
7
8
Host github.com
  IdentityFile ~/.ssh/id_ed25519
  User git
  PreferredAuthentications publickey
  Hostname ssh.github.com
  Port 443
  TCPKeepAlive yes
  IdentitiesOnly yes

생성된 SSH 키를 클론해 올 레포지토리에 등록 (참고)
- Github 사이트로 이동
- 우상단의 프로필을 클릭하여 드롭다운 메뉴에서 Settings로 이동
- SSH and GPG Keys 메뉴로 이동
- New SSH Key 버튼 클릭하고 앞에서 복사한 SSH 키 붙여넣기

깃허브 서버에 SSH로 접근 가능한지 확인합니다. 활성 터미널에서 최초 1회 실행하고 yes를 입력해 주면 SSH 연결로 리포지토리 클론 및 변경사항 푸시 등을 자격증명 없이 수행할 수 있습니다.

        
      
 ~/.ssh $ ssh -T git@github.com
 The authenticity of host '[ssh.github.com]:443 ([20.200.245.248]:443)' cannot be established.
 ED25519 key fingerprint is SHA256:xxx.
 This key is not known by any other names.
 Are you sure you want to continue connecting (yes/no/[fingerprint])?

3.3. 레포지토리 클론(clone)

mkdir 커맨드로 로컬 저장소에 적당한 디렉토리를 만듭니다.
cd 커맨드를 이용해 위에서 만든 디렉토리로 이동합니다.

git clone 커맨드를 이용해 레포지토리를 클론합니다.

HTTPS 방식으로 클론하는 경우

1
2
3
   mkdir ~/storage/shared/repos
   cd ~/storage/shared/repos
   git clone https://github.com/lazyjobseeker/lazyjobseeker.github.io.git

SSH 방식으로 클론하는 경우

1
2
3
   mkdir ~/storage/shared/repos
   cd ~/storage/shared/repos
   git clone git@github.com:lazyjobseeker/lazyjobseeker.github.io.git

4. Ruby 설치

Ruby를 설치합니다.

1
pkg install ruby

5. 모바일 로컬에서 서버 구동하기

여기까지 완료되었다면 거의 모든 준비가 끝났습니다. 클론된 리포지토리의 로컬 저장소로 이동한 다음, 의존성이 있는 gem들을 설치하기 위해 bundle install을 한 번 실행해 줍니다. Jekyll을 별도로 설치하지 않았지만, 제가 사용하고 있는 Minimal Mistakes 테마의 경우 Jekyll에 대한 의존성을 이미 선언하고 있기 때문에 굳이 Jekyll을 먼저 설치하지 않아도 상관이 없었습니다.

의존성 gem들의 설치까지 완료되었다면 bundle exec jekyll serve를 실행한 다음, 실행이 성공하면 PC 환경에서와 동일하게 로컬 서버 주소(http://127.0.0.1:4000/)에서 렌더링된 정적 홈 페이지를 확인할 수 있습니다.

        
      
cd ~/storage/shared/repos/lazyjobseeker.github.io
bundle install
bundle exec jekyll serve
To use retry middleware with Faraday v2.0+, install `faraday-retry` gem
Configuration file: /storage/emulated/0/repos/lazyjobseeker.github.io/_config.yml
            Source: /storage/emulated/0/repos/lazyjobseeker.github.io
       Destination: /storage/emulated/0/repos/lazyjobseeker.github.io/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
       Jekyll Feed: Generating feed for posts
                    done in 7.517 seconds.
 Auto-regeneration: enabled for '/storage/emulated/0/repos/lazyjobseeker.github.io'
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

bundle exec jekyll serve를 실행할 때 아래와 같이 추가 옵션을 주지 않으면 css 디자인이 깨진다는 포스트도 있었지만, 저의 경우에는 필요하지 않았습니다. 서버는 구동되지만 렌더링된 결과가 이상하다면 아래를 실행해 보는 것도 좋겠습니다.

        
      
bundle exec jekyll serve --baseurl ''

6. 문제 해결

여기까지의 과정이 아무 문제 없이 진행되었을 수도 있지만, 문제가 발생할 수도 있습니다. 제가 겪었던 문제점 및 해결 방법들은 아래와 같습니다.

6.1. nokogiri 설치 불가

nokogiri는 Ruby에서 XML과 HTML을 다루기 용이하게 하는 API들을 제공하는 라이브러리입니다. bundle install로 의존성 gem들을 설치하는 과정에서, 다른 모든 gem들은 문제없이 설치가 가능한데 nokogiri는 설치에 실패했다는 메시지와 함께 진행이 불가능한 문제가 있었습니다.

몇 가지 패키지를 추가로 설치하여 해결되었다는 스택오버플로우 포스트 가 있었고 이를 따르는 것으로 해결되었습니다. 어떤 포스트에서는 패키지 업데이트를 하라는 권고가 있었습니다.

정확히 어떤 지침을 따라야 해결되는 것인지 알 수가 없어서, 모두 진행했습니다.

        
      
# 패키지 업데이트 및 업그레이드
pkg update
pkg upgrade
# 패키지 추가 설치
pkg install pkg-config
pkg install binutils
pkg install gumbo-parser
pkg install libxslt
pkg install libxml2
pkg install build-essential --no-install-recommends
# gem 추가 설치
gem install pkg-config

그런 다음, bundle install 대신 아래 명령으로 nokogiri gem을 직접 설치하면 정상적으로 설치됩니다.

        
      
gem install nokogiri --platform=ruby -- --use-system-libraries

6.2. bundle exec jekyll serve 실행 시 권한 없음

위 문제를 해결하여 모든 gem들을 설치한 후, bundle exec jekyll serve로 로컬 서버를 구동하려고 하자, 아래와 같은 오류가 발생하며 진행이 되지 않았습니다.

        
      
bundle exec jekyll serve
To use retry middleware with Faraday v2.0+, install `faraday-retry` gem
Configuration file: /storage/emulated/0/repos/lazyjobseeker.github.io/_config.yml
            Source: /storage/emulated/0/repos/lazyjobseeker.github.io
       Destination: /storage/emulated/0/repos/lazyjobseeker.github.io/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
       Jekyll Feed: Generating feed for posts
                    done in 7.442 seconds.
jekyll 3.9.5 | Error:  Permission denied @ rb_sysopen - /proc/version
/data/data/com.termux/files/usr/lib/ruby/gems/3.2.0/gems/jekyll-3.9.5/lib/jekyll/utils/platforms.rb:73:in `read': Permission denied @ rb_sysopen - /proc/version (Errno::EACCES)

한 포스트에서 조치 방법을 확인할 수 있었습니다. 로컬에 설치된 Jekyll의 루비 소스 코드 파일 중 /lib/jekyll/utils/platfroms.rb 파일을 직접 수정하는 것입니다. 구체적으로는, proc_version 함수를 아래와 같이 고쳐 줍니다.

        
      
def proc_version
  @proc_version ||= begin
    Pathutil.new(
      "/proc/version"
    ).read
  rescue Errno::ENOENT, Errno::EACCES
    nil
  end
end

Jekyll이 어디에 설치되어 있는지 모르겠다면, 아래 명령을 실행해 확인해 봅니다.

1
2
bundle show jekyll
>>> /data/data/com.termux/files/usr/lib/ruby/gems/3.2.0/gems/jekyll-3.9.5

즉, 수정이 필요한 파일의 최종 경로는,

1
/data/data/com.termux/files/usr/lib/ruby/gems/3.2.0/gems/jekyll-3.9.5/lib/jekyll/utils/platforms.rb

위와 같이 특정할 수 있었습니다. 이 문제는 제가 가지고 있는 스마트폰과 태블릿에서 모두 발생했고, 위 조치로 동일하게 해결 되었습니다.

7. 깃허브 블로그 리포지토리의 로컬 저장소를 Obsidian vault로 연동

원래 태블릿에서는 포스트 수정과 git 작업을 동시에 하기 위해 파일 수정 기능과 함께 git의 일부 기능을 기본적으로 지원하는 스펙 에디터(spck editor)를 사용하고 있었습니다. 스펙 에디터의 마크다운 편집 및 프리뷰 기능은 옵시디언에 비하면 아쉽지만, git 기능을 사용할 수 있는 장점 때문에 사용해 왔습니다.

항상 셋업하고 싶었던 모바일 블로그 포스팅 환경은 스펙 에디터에서 git clone 명령으로 로컬 저장소에 복제해 온 레포지토리를 옵시디언 저장소(Vault)로 지정하여, 실제 포스트 작성과 수정은 옵시디언에서 처리하고 커밋과 푸시만 스펙 에디터로 진행하는 것이었습니다. 옵시디언에도 Obsidian Git이라는 커뮤니티 플러그인이 있어 git 기능을 사용할 수 있지만 안정성이 크게 떨어져서 사용하지 않고 있었고, 스펙 에디터에서 모바일 단말로 클론해온 로컬 저장소는 옵시디언에서 접근할 수 없는 위치(스펙 에디터의 앱 내부 저장소)에 있어서, 어쩔 수 없이 마크다운 편집과 프리뷰는 옵시디언으로 작업한 다음 스펙 에디터는 git 관련 처리에만 사용하고 있었습니다.

하지만 Termux로 git을 설치하고 git을 이용해 어느 앱이든 접근 가능한 스토리지 영역에 리포지토리를 클론할 수 있게 되었기 때문에, 클론해온 리포지토리의 태블릿 내부 저장 위치를 옵시디언 vault로 직접 지정하여 포스트를 직접 작성하고 수정할 수 있게 되었습니다.

옵시디언의 Manage Vaults -> Open Folder as Vault 메뉴로 접근하여, Termux에서 git으로 클론한 저장소 위치를 Vault로 직접 지정했습니다. 포스팅을 위한 마크다운 파일만 수정할 목적이기 때문에, 전체 저장소가 아닌 _posts 폴더만을 타겟으로 지정했습니다. 주의할 점은 옵시디언에서 Vault의 이름을 바꾸면 대상 디렉토리의 이름 자체가 바뀌기 때문에, 별로 보기에 좋지 않더라도 이렇게 만든 Vault의 이름은 _posts인 채로 유지해야 한다는 점입니다. 또한 옵시디언 Vault로 지정된 디렉토리에는 옵시디언 관련 설정들을 저장하는.obsidian 폴더가 새로 생성되기 때문에, git이 이 파일들을 추적하기를 원하지 않는다면 .gitignore에서 이 파일들을 추적하지 않도록 설정해 주어야 합니다.

Share on

Twitter Facebook LinkedIn

모바일 환경에서 깃허브 블로그 관리하기

1. F-Droid 앱 스토어 및 Termux 설치

2. Termux 설정

3. git 설치 및 설정

3.1. git 설치 및 설정

3.2. SSH Key 생성 및 Github 레포지토리에 등록

3.3. 레포지토리 클론(clone)

4. Ruby 설치

5. 모바일 로컬에서 서버 구동하기

6. 문제 해결

6.1. nokogiri 설치 불가

6.2. bundle exec jekyll serve 실행 시 권한 없음

7. 깃허브 블로그 리포지토리의 로컬 저장소를 Obsidian vault로 연동

Share on

You may also enjoy

adb shell의 chmod, chown 명령어

모바일 환경에서 깃허브 블로그 관리하기

자바스크립트로 객관식 문제 만들기

파이썬 설치, 환경 변수, 프로젝트 패키징