깃북 기능

위키 문서 작성 및 머지 신청

  1. 처음 로그인 시 화면

작업을 시작하기 위해 베어타운만 선택하여 창 페이지를 닫아줍니다.

  1. 수정 파일 생성

상단에 #000 [ 수정본 제목] 뒤에 Merged 되어있는 페이지가 뜬다면 뒤로가기를 눌러줍니다.(아닐 수도 있음)
새로운 수정본을 생성하기 위해 Edit 버튼을 눌러줍니다.

  1. 수정하기

적절한 내용을 위키에 수정하면 됩니다. 빨간 칸에 대략적인 수정사항을 작성하고 시작합니다.

  1. 머지 신청

Request a reivew 클릭 시 머지 신청이 됩니다.

머지 신청이 정상적으로 완료 되었다면 상단에 In review로 표시됩니다.

이후 위키 쓰레드에 다음 형식으로 변경사항을 작성합니다.

마크 다운 및 링크

원하는 구역을 드래그 한 후 알맞은 버튼을 누르면 됩니다.

1 : Bold 2 : 하이라이트 3 : 색 변경 4. 링크

링크를 걸 때는 페이지 제목으로 검색해야 하며 적절한 링크를 걸어줘야 유저분들이 더 편히 정보를 찾고 컨텐츠 이해에 도움을 줄 수 있습니다. 링크는 기본적으로 파란색으로 표시되며 색을 그 위에 입힐 수도 있습니다. 링크 시스템은 페이지의 위에서 순서대로 1,2,3,4 이런식으로 메기기 때문에 Heading의 순서를 바꾸면 다른 링크가 들어갈 수도 있습니다. 링크를 걸었던 페이지가 삭제된다면 Broken link로 표시됩니다. 이걸 하나하나 찾는건 어렵지만 로그인 직후 화면에서 몇개의 Broken link가 어디에 있는지 알려주니 참고하여 작업하면 됩니다.

블록 생성 및 종류

깃북은 여러가지 블록들이 사용됩니다. Enter을 누르면 기본적으로 새로운 블록의 paragraph가 생성됩니다. Shift + Enter을 누르면 줄바꿈은 되지만 블록은 생성되지 않습니다.

깃북에는 다양한 블록이 있습니다. 블록의 종류는 다음 링크에서 확인할 수 있습니다.

LogoBlocks | GitBook Documentationdocs.gitbook.com

위키를 작성하며 주요하게 사용하게 되는 블록들에 대해서 세부적으로 설명하겠습니다.

  1. paragraph

    1. 설명 : 가장 기본적인 설명 글에 해당하는 Block 입니다.

    2. 생성방법 : Enter

  2. Heading

    1. 설명 : 페이지의 소제목을 작성할때 사용합니다. Heading 1~3이 존재합니다.

    2. 생성방법 : / 입력 후 Heading1~3중 적절한걸 선택

    3. 특이사항 : Heading 3은 Paragraph과 차이가 거의 없기 때문에 Heading1, Heading2를 주로 사용합니다. 글씨의 크기를 보고 적절한걸 골라주세요.

  3. Hint

    1. 설명 : 길라잡이 등의 제한이 있는 컨텐츠나 유의사항을 표시할떄 사용하는 블럭입니다. 패치 예정, 비활성화 된 내용임을 알릴때도 사용합니다. ( Success : 길라잡이 제한, Info : 패치 예정. 나머지는 적절한거 사용)

    2. 생성방법 : / 입력 후 Hint 클릭. 6개의 점 클릭한 후 형식 변경(점6개는 마우스 커서 올리면 표시됨)

예시 :

제작에 다양한 방법으로 재료를 구해야할 때 색을 구분하여 작업한 후 상단에 Hint - info로 어떤 경로를 의미하는지 작성함.

  1. Quote

    1. 설명 : 예시를 제시할때 보통 사용하는 기능입니다.

    2. 생성방법 : / 입력 후 Quote 클릭.

    예시 :

  2. Code Block

    1. 설명 : 설정 방법을 설명할때 사용하는 기능입니다. Code Block을 사용하면 내용이 단정해보이는 효과가 있습니다.

    2. 생성방법 : / 입력 후 Code Block 클릭.

  1. Table

    1. 설명 : 표입니다. 자료를 정리할 때 한번 작업하면 수정이 쉽습니다. 따라서 위키 작업에서 데이터 정리의 대부분은 표를 이용합니다. 근데 깃북 표 시스템이 정말 쓰레기입니다. 다음과 같은 특징이 있습니다.

      • 셀 합치기 기능 없음

      • Table을 작업할때 Enter 입력시 줄바꿈이 아닌 셀 추가가 됨. 줄바꿈을 위해서는 Shift + Enter을 사용해야함.

      • 한 줄에 글이 너무 길면 자동 줄바꿈이 되는데 끝에 넘어가는 부분을 잘라서 다음줄로 넘기는게 아니라 중간에서 뚝 잘라서 다음줄로 넘김. 이 경우에 엄청 튀며 표의 Header은 짤리지 않는다.(이 말은 행의 수가(가로) 너무 많으면 기본적인 Header의 길이가 있기 때문에 한 행에 배정되는 간격이 짧음. 따라서 모두 다 짤려서 넘어가서 표가 개판되는걸 확인할 수 있음.) 따라서 2가지를 꼭 기억해야 합니다. 1. 표를 옆으로 길게 만들지 않도록 합칠 수 있는 내용은 최대한 합친다. 2. 표 작업 마무리 전 항상 우측 상단의 Preview 버튼을 눌러서 어떻게 반영되었는지 꼭 확인하고 넘어가기. 의도와 다르게 변경되었다면 아마 수정을 진행하게 될텐데 또 Preview가 곧바로 반영 안되고 많은 시간이 지나야 반영되는 경우도 있습니다. 따라서 Preview 반영이 되었는지 확인할 수 있는 sign을 남겨주세요.

      • 옆으로의 간격이 자유롭게 변경되지 않음. 이건 Auto Size 기능 때문인데 또 Auto Size 기능을 빼고 작업하면 옆으로 꽉 차지 않음.(깃북은 작업창과 실제 적용 페이지의 옆 간격이 다르다.)

    2. 생성방법 :/ 입력 후 Table 클릭. 또는 구글 문서에서 먼저 작업을 진행한 후 표를 드래그해서 붙여넣기. 이 방법은 Header이 숨겨진 상태로 옮겨져 옵니다. 점6개를 눌러 Header 숨기기를 끄고 표를 한칸 위로 옮겨주세요.

진짜로 표 작업하다가 수명 5년 줄었습니다..(-치즈)

  1. Tabs

    1. 설명 : 비슷한 내용이 여러번 반복되거나 너무 긴 제작 테이블 같은걸 나눠서 정리할때 사용하는 블록입니다. 직관적으로 보이는 것과 같으며 Tabs 안에 다른 블록을 넣기 위해서는 Tabs 밖에서 블록 생성 후 드래그하면 됩니다.

    2. 생성방법 :/ 입력 후 Tabs 클릭.

  2. Unordered list, Ordered list

    1. 설명 : 리스트 형태로 정리하는 방법입니다. 치즈가 정말 좋아하는 정보 정리 방법입니다.

    2. 생성방법 :/ 입력 후 Unordered List or Ordered List 클릭. - 또는 1. 입력 후 띄어쓰기 해도 됩니다.

  3. Math&Tex

    1. 설명 : 수식입니다.

이미지 및 GIF 넣는법

  • 큰 이미지 넣는법 : / -> insert image -> 원하는 이미지 끌어다 넣기 or 파일 찾기로 넣기 -> 업로드를 기다리고 클릭하면 들어갑니다. 이미지 상단의 점 3개를 눌러서 사이즈를 변경해보세요.

  • 작은 이미지 넣기 : 이미지 파일을 구글 닥스에 끌어서 붙인다. -> 해당 이미지를 복사한 후에 원하는 위치에 붙여넣기 한다. 이와 같은 이미지는 글로 판정됩니다. 이 이미지를 클릭하면 다음 아이콘이 뜹니다.

왼쪽부터 세로줄에 맞추기, 원본 사이즈, 큰 이미지로 넣기입니다.

+ 글자 크기 맞게 맞추기 or 원본 이미지 밖에 없습니다. 따라서 원하시는 이미지 크기가 있다면 변환 프로그램을 사용하여 이미지를 변환해야합니다.

깃북은 파일(영상)을 바로 띄우는 기능은 없으며(유튜브는 가능) 한번 클릭해야 해당 영상을 확인할 수 있음. 유저분들에게 안내할때는 최대한 한눈에 들어오도록 하는것이 좋기 때문에 GIF 이미지를 적절히 활용해야합니다

보통 화면 녹화로 영상을 촬영한 후 GIF 변환 사이트에서 변환하면 됩니다.

Previous시작하기(위키)Next위키 가이드 라인

Last updated