meta

이 사이트에 기여하기

[번역 필요]

Thank you for your interest in in helping to build the Code for Seoul community site. We warmly welcome comments, corrections and additions, as well as suggestions for additional sections and areas to examine.

How this site works

이 사이트를 다듬는데 기여하기 위해서는 사이트가 동작하는 원리에 대해 조금의 이해가 필요합니다. 세부적인 내용까지 다루지는 않겠지만 다음의 도구들을 살펴보시면 기여하시는데 도움이 될 것입니다.

  • GitHub
  • Jekyll
  • Markdown

GitHub

무엇인가요?

GitHub은 웹을 기반으로 깃 레포지토리를 호스팅해주는 서비스로 웹 기반의 그래픽 인터페이스를 통해 버전 관리와 소스코드 관리를 제공합니다.

왜 알아야 하나요?

만일 여러분이 어떤 내용을 편집하거나 새로 만들고 싶을 때 어떤 일이든 Github을 통해서 이뤄집니다(it is also possible to download and edit the files on your local machine, instructions for this method will be added in the future). 이 사이트를 구성하는 모든 파일들은 Github에서 검색하고 편집할 수 있습니다. 한번도 사용해보신 적 없는 분들은 회원가입이 필요할 것입니다. 더 자세한 안내 사항은 페이지 편집하기를 참조하세요.

Jekyll

What is it?

Jekyll is a static site generator, which allows us to host websites based on our GitHub repositories. Jekyll takes the content, renders Markdown, and produces a complete, static website ready to be viewed on the web.

Why should I care?

All you really need to know about Jekyll is the method it uses to include metadata (ie. page title). Each page needs to start with a section it calls Front Matter, containing the page title. An example is provided in the Adding a page section.

Markdown

What is it?

Markdown is a markup language with plain text formatting, designed so that it can be converted to HTML. Markdown can be used to create rich text using a plain text editor.

Why should I care?

Markdown is your key to formatting the text your provide for this site. By learning a few intuitive rules you’ll be able to ensure your text is formatted with headings, list, quotes etc, without writing any HTML. For examples, head to the Markdown section.