문서 공개
편집한 내용을 공개해, 인터넷에서 누구나 열람할 수 있는 공개 페이지로 만드는 방법을 설명합니다.
작업 중인 내용과 공개 중인 버전
Monjiro에서는 편집하고 있는 내용(작업 중인 내용)과 독자가 열람하는 내용(공개 중인 버전)을 나눠 관리합니다. 편집해도 공개하기 전까지는 공개 페이지가 바뀌지 않습니다.
공개한 뒤에 편집하면 오른쪽 패널의 "버전"에 "공개하지 않은 변경 있음"이 표시됩니다. 편집한 뒤 원래 내용으로 되돌린 경우에는 표시되지 않습니다.
공개하기 전에 변경 사항 확인하기
공개한 뒤에 편집한 내용은 최신 공개 버전과 비교해 페이지별로 확인할 수 있습니다.
- 편집 화면에서 확인할 페이지를 엽니다.
- 본문 오른쪽 위의 "변경 사항"을 클릭합니다.
- 페이지가 평소 모습에 변경 사항 표시가 붙은 상태로 표시됩니다. "변경 사항"을 다시 클릭하면 편집으로 돌아갑니다.
본문의 변경 사항에는 다음과 같은 표시가 붙습니다.
| 표시 | 의미 |
|---|---|
| 왼쪽의 초록색 선 | 추가한 블록 |
| 왼쪽의 노란색 선 | 내용을 변경한 블록. 추가한 문자에는 밑줄이, 삭제한 문자에는 취소선이 표시됩니다. |
| 왼쪽의 파란색 선 | 위치만 이동한 블록 |
| 왼쪽의 빨간색 선과 취소선이 그어진 문자 | 삭제한 블록. 삭제하기 전에 있던 위치에 표시됩니다. |
페이지 제목, 페이지 설명, 공개 페이지에서의 표시 여부(비공개 설정)를 변경한 경우에는 본문 위에 모아서 표시됩니다.
변경 사항을 표시하는 동안에는 왼쪽 페이지 목록에도 표시가 붙습니다.
- 변경된 페이지: 제목 왼쪽에 점이 표시됩니다(초록: 추가한 페이지, 노랑: 내용을 변경한 페이지, 파랑: 이동만 한 페이지).
- 삭제한 페이지: 페이지 목록 아래의 "공개 후 삭제한 페이지"에 표시됩니다.
변경 사항을 표시한 채로 왼쪽 페이지 목록에서 다른 페이지를 열면, 그 페이지의 변경 사항이 표시됩니다.
- 변경 사항을 표시하는 동안에는 편집할 수 없습니다.
- "변경 사항"은 한 번이라도 공개한 문서에서 표시됩니다. 공개를 중지한 경우에도 최신 공개 버전과 비교합니다.
- 번역 언어를 선택한 경우에는 그 언어의 내용을 비교합니다. 비교하는 버전에 그 언어가 없었다면 모두 "New"로 표시됩니다.
공개하기
- 편집 화면 오른쪽 위의 "미리보기"에서 공개했을 때의 모습을 확인합니다.
- 오른쪽 패널의 "문서" 탭 맨 위에 있는 "공개"를 클릭합니다.
- 공개 방법을 선택하고, 필요하면 메모를 입력한 뒤 "공개"를 클릭합니다.
| 공개 방법 | 설명 |
|---|---|
| 새 버전으로 공개 | 공개 이력에 새 버전(v1, v2…)으로 남습니다. |
| 최신 버전 덮어쓰기 | 최신 버전의 내용을 교체합니다. 오탈자 수정 등 이력에 남길 필요가 없는 변경에 사용합니다. |
메모는 버전 목록에 표시됩니다(예: "3단계 추가").
공개 URL
공개 페이지의 URL은 오른쪽 패널 "문서" 탭의 "공개"에 표시됩니다. 공개 중에는 URL 옆의 아이콘을 클릭하면 공개 페이지가 열립니다.
서브도메인(URL의 앞부분)을 변경하려면 다음 절차를 따릅니다.
- 오른쪽 패널의 "설정" 탭을 엽니다.
- "접근"의 "공개 URL" 항목에 있는 "변경"을 클릭합니다.
- 새 서브도메인을 입력하고 "변경"을 클릭합니다.
- 서브도메인 변경은 공개를 기다리지 않고 즉시 반영됩니다.
- 서브도메인에는 영문 소문자·숫자·하이픈을 사용할 수 있습니다(3~63자. 처음과 끝은 하이픈 불가).
- 다른 문서에서 사용 중인 서브도메인이나 예약된 서브도메인은 사용할 수 없습니다.
- 공개 중인 문서의 URL을 변경하면 그동안 공유한 링크는 사용할 수 없게 됩니다.
페이지 비공개로 하기
작성 중인 페이지나 아직 공개하고 싶지 않은 페이지는 페이지별로 비공개로 할 수 있습니다. 비공개 페이지는 문서에 남긴 채 공개 페이지에는 표시하지 않습니다.
- 편집 화면에서 비공개로 할 페이지를 엽니다.
- 오른쪽 패널의 "페이지" 탭을 엽니다.
- "공개 설정"의 "이 페이지를 비공개로 하기"를 켭니다.
- 문서를 공개합니다. 비공개 설정은 공개했을 때 반영됩니다.
비공개 페이지는 다음과 같이 처리됩니다.
- 하위 페이지도 비공개: 비공개 페이지 아래에 있는 하위 페이지는 모두 비공개가 됩니다. 하위 페이지에서 설정을 꺼 두어도, 부모 페이지가 비공개이면 공개 페이지에 표시되지 않습니다.
- 공개 페이지에 표시되지 않음: 페이지 트리, 이동 경로(브레드크럼), 페이지 트리 블록에 표시되지 않습니다. URL을 직접 열어도 페이지를 찾을 수 없다는 안내가 표시됩니다.
- 검색·AI 채팅 대상에서 제외: 사이트맵에 실리지 않으며, 독자용 AI 채팅도 비공개 페이지의 내용을 답변에 사용하지 않습니다.
- 편집 화면의 표시: 왼쪽 페이지 목록에서 비공개 페이지 오른쪽에 비공개 표시(눈에 사선이 그어진 아이콘)가 붙습니다. 부모 페이지가 비공개여서 비공개가 된 페이지는 표시가 연하게 보입니다.
- 미리보기: 페이지 목록 등에는 표시되지 않지만, 비공개 페이지를 열어 미리보기하면 내용을 확인할 수 있습니다.
첫 페이지(루트 페이지)는 공개 페이지의 입구이므로 비공개로 할 수 없습니다. 문서 전체를 열람할 수 없게 하려면 아래의 "공개 중지하기"를 이용해 주세요.
검색 엔진에 노출하기
공개 페이지를 Google 등의 검색 결과에 표시할지 선택할 수 있습니다. 처음에는 노출하지 않도록 설정되어 있습니다. 검색으로 공개 페이지를 찾을 수 있게 하려면 켜 주세요.
- 편집 화면 오른쪽 패널의 "설정" 탭을 엽니다.
- "공개 페이지"의 "검색 엔진에 노출"을 켭니다.
이 설정은 공개를 기다리지 않고 즉시 반영됩니다.
- 꺼져 있을 때: 공개 페이지에 검색 엔진에 노출하지 않기 위한 표시(noindex)를 붙입니다. URL을 아는 사람은 이전처럼 공개 페이지를 열람할 수 있습니다.
- 미리보기·삽입한 채팅: 편집 화면의 미리보기와 다른 사이트에 삽입한 AI 채팅은 설정과 관계없이 검색 결과에 표시되지 않습니다.
사이트맵(sitemap.xml)
검색 엔진에 노출하도록 설정한 경우, 공개 중인 페이지 목록(사이트맵)을 공개 페이지 URL의 /sitemap.xml(예: https://docs.example.com/sitemap.xml)에 공개합니다. 검색 엔진은 사이트맵에서 페이지를 찾습니다.
- 사이트맵의 위치는 /robots.txt로도 검색 엔진에 알립니다.
- 노출하지 않도록 설정했거나 열람 제한을 걸었을 때는 사이트맵을 공개하지 않습니다.
- 페이지를 추가·삭제하고 공개하면 사이트맵도 자동으로 업데이트됩니다.
켜더라도 검색 결과에 표시되기까지는 검색 엔진에 따라 며칠에서 몇 주가 걸릴 수 있습니다. 빨리 노출하려면 Google Search Console 등에 사이트맵 URL(/sitemap.xml)을 등록해 주세요.
공개 중지하기
오른쪽 패널의 "문서" 탭 맨 위에 있는 "공개 중지"를 클릭하면 독자가 문서를 열람할 수 없게 됩니다. 공개한 버전의 이력은 남아 있으며, 나중에 다시 공개할 수 있습니다.