필자 만든 소스 코드가 GitHub에 올린 것들이 20여 가지가 넘어간다.
소스 코드도 중요 하지만 이것을 잘 설명하는 것도 무척 중요한 것 같다. 거기에 예쁘게 꾸밀 수 있다면 이건 신이 주신 능력임이 분명할 거다. ㅠ

Markdown ToC (Table of Contents)

이런 어려움에 착안하여 Markdown ToC를 만들어 GitHub에 공개했다.
링크 : https://github.com/powerumc/markdown-toc

Markdown ToC는 Markdown 문법을 이용하여 만든 문서에 목차를 만들어 주는 라이브러리이다. 진짜 별 거는 아니고, 필자가 필요해서 쓱~ 만들었다.

MIT 라이센스로 공개 했으며, 이미 잘 만들어진 marked.js, tocify.js 라이브러리를 조합하여 간단하게 만들어 보았다.

디자인이나 기능을 추가 하신 분은 Pull Request 올려 주세요.

아래는 Markdown Toc로 만들어 본 필자 저장소의 gh-pages 웹 페이지이다. (현재 모바일 미 지원)

Features

사소하지만 몇 가지 특징이 있다.

  1. Markdown ToC 코드를 받고 원하는 곳에 올리기만 하면 된다. (gh-pages 브랜치 등)
  2. 브라우저에서 실시간으로 Markdown 파일을 랜더링한다.
  3. README.md 파일만 수정하고 로컬 컴파일이 필요 없다.
  4. Jekyll, Assemble 등 템플릿 문법을 익힐 필요가 없다.
  5. 심플하다.

How to - Beginner

1. 소스 코드 다운로드

필자의 GitHub 저장소에서 master.zip 파일을 다운로드 받고, 풀면 된다.

2. 올리고 싶은 곳에 올린다

올리고 싶은 곳에 올리면 된다.

How to - Pro Git

1.다음과 같이 Markdown ToC 를 clone 한다.

$ git remote add markdown-toc https://github.com/powerumc/markdown-toc.git  

2.GitHub에서 웹 페이지를 호스팅 할 수 있는 gh-pages 브랜치를 생성하고, Markdown ToC 소스 코드를 받는다.

$ git checkout --orphan gh-pages  
$ git rm -rf .  
$ git commit -am "remove all file for gh-pages"  
$ git pull markdown-toc master:gh-pages  

3. 콘텐트 수정 또는 생성

README.md 파일에 원하는 콘텐트로 채운 후에 커밋을 하면 된다.

$ git commit -am "init commit."  

만약 다른 브랜치에 이미 만들어 놓은 README.md 파일이 있으면 gh-pages 브랜치로 가져오면 된다.

$ git checkout master -- README.md  
$ git commit  

3. GitHub 에 Push 한다.

$ git push origin gh-pages  
Posted by 땡초 POWERUMC

댓글을 달아 주세요

지난 2013년 7월부터 MonoDevelop 공식 프로젝트를 Fork 하여 MonoDevelop Korean 프로젝트를 진행 하였습니다.

그 결과 한 달을 매달려 약 4,500여 문장을 번역하였습니다.
그냥 번역 작업만 하면 쉽게 생각하겠지만, IDE 툴에서 보여주는 메시지를 영문으로 보여야 할지, 한글로 보여야 할지… 여러 문장이 합쳐지면 어색해 지지 않는지… 그리고 직역을 하게 되면 의미가 잘못 전달되지 않는지… 번역에 따른 크래시 버그…. 이런 작업을 일일이 확인 하다보니 한 달이라는 시간이 지났던 것이죠;;;

앞으로 이 사이트를 통해 지속적으로 한글 번역과 개선 작업을 진행 할 예정입니다.

http://monodevelop.co.kr

Posted by 땡초 POWERUMC

댓글을 달아 주세요

  1. 컴포지트 2014.05.13 09:40 Address Modify/Delete Reply

    노고에 감사드립니다.

  2. 붉은용기병 2014.05.15 11:32 Address Modify/Delete Reply

    와...우....

    감사합니다.




  3. 테릿 2014.09.19 05:12 Address Modify/Delete Reply

    우분투용은 언제 나오나요 -0-;

    무척이나 기다리고 있답니다~~~

  4. 테릿 2014.09.19 05:12 Address Modify/Delete Reply

    우분투용은 언제 나오나요 -0-;

    무척이나 기다리고 있답니다~~~

  5. 도라킹 2015.01.19 13:43 Address Modify/Delete Reply

    윈도우는 언제 나오나요... --;