OpenProject 위키 상세 안내서

OpenProject 위키 상세 안내서

2025-09-06, G25DR

1. OpenProject 위키 시작하기

1.1 위키 모듈의 역할과 가치: 협업 문서화의 중심

OpenProject 내에서 위키(Wiki) 모듈은 프로젝트 관련 정보와 문서를 협업적으로 생성하고 관리하는 중앙 허브 역할을 수행한다.1 이 모듈은 프로젝트의 요구사항 명세, 기술 가이드라인, 회의록, 팀의 공유 지식 등 모든 핵심 정보를 체계적으로 축적하기 위해 설계되었다. 단순한 정보 저장을 넘어, 팀원들이 실시간으로 지식을 공유하고 발전시켜 나가는 동적인 지식 베이스(Knowledge Base)를 구축하는 것을 목표로 한다.

OpenProject는 그 자체로 모듈식 구조를 채택하고 있어, 각 프로젝트의 필요에 따라 기능을 활성화하거나 비활성화할 수 있다.2 위키는 간트 차트, 애자일 보드, 작업 패키지 등과 같은 핵심 모듈 중 하나로, 문서화의 중요성이 높은 프로젝트에서 그 가치가 극대화된다.2 이는 OpenProject가 단순 과업 관리부터 복잡한 기술 프로젝트에 이르기까지 넓은 스펙트럼의 프로젝트를 지원할 수 있도록 하는 유연한 설계 철학을 반영한다. 위키 모듈을 활성화하는 것은 프로젝트를 단순한 작업 목록 관리에서 벗어나, 체계적인 지식 관리 중심으로 전환하겠다는 의사결정이라 할 수 있다.

1.2 프로젝트 설정에서 위키 모듈 활성화하기

기본적으로 새로운 OpenProject 프로젝트에서는 위키 모듈이 비활성화되어 있다. 따라서 위키 기능을 사용하기 위해서는 프로젝트 관리자가 직접 모듈을 활성화해야 한다.3

활성화 절차는 다음과 같다.

  1. 해당 프로젝트의 좌측 탐색 메뉴에서 Project settings으로 이동한다.

  2. 설정 메뉴에서 Modules 탭을 선택한다.

  3. 표시되는 모듈 목록에서 Wiki 항목 옆의 체크박스를 선택하여 활성화한다.

이 과정을 완료하면 프로젝트의 좌측 주 탐색 메뉴에 ‘Wiki’ 항목이 즉시 나타나며, 모든 프로젝트 멤버가 위키에 접근할 수 있게 된다.3 이 절차는 프로젝트 관리 권한을 가진 사용자만이 수행할 수 있다.

1.3 위키 인터페이스 첫걸음: 메인 페이지, 사이드바, 툴바 살펴보기

위키 모듈이 활성화되면 사용자는 세 가지 주요 구성 요소로 이루어진 인터페이스를 마주하게 된다.

  • 메인 페이지 (Main Page): 화면의 가장 넓은 중앙 영역을 차지하며, 선택된 위키 페이지의 본문 내용이 표시된다. 모든 읽기, 편집, 상호작용이 이 공간에서 이루어진다.

  • 사이드바 (Sidebar) / 위키 메뉴: 화면 좌측에 위치하며, 해당 프로젝트에 속한 모든 위키 페이지의 계층 구조를 트리 형태로 보여준다.3 사용자는 이 메뉴를 통해 전체 위키의 구조를 한눈에 파악하고 원하는 페이지로 신속하게 이동할 수 있다.

  • 툴바 (Toolbar): 메인 페이지 우측 상단에 위치하며, 위키 페이지에 대한 핵심적인 작업을 수행하는 버튼들이 모여 있다.3

  • + Wiki page: 새로운 위키 페이지를 생성하는 녹색 버튼이다.

  • Edit: 현재 보고 있는 페이지의 내용을 편집한다.

  • Watch: 페이지의 변경 사항이 있을 때마다 알림을 받도록 구독한다.

  • More: 클릭 시 드롭다운 메뉴가 나타나며, 페이지 히스토리(History) 확인, 잠금(Lock), 삭제(Delete), 내보내기(Export) 등 추가적인 고급 기능을 제공한다.4

2. 위키 페이지 생성 및 관리

OpenProject 위키는 페이지의 전체 생명주기를 체계적으로 관리할 수 있는 강력한 기능들을 제공한다. 이는 단순한 문서 작성을 넘어, 문서의 버전을 관리하고 협업의 투명성을 보장하는 엔터프라이즈급 기능을 지향한다.

2.1 새 위키 페이지 생성

새로운 위키 페이지를 생성하려면 우측 상단 툴바의 녹색 + Wiki page 버튼을 클릭한다.3 버튼을 클릭하면 다음과 같은 항목을 입력하는 편집기 화면이 나타난다.

  • Page title: 페이지의 제목을 입력한다. 이 제목은 위키 메뉴와 페이지 상단에 표시된다.

  • Content: 페이지의 본문 내용을 WYSIWYG 편집기를 사용하여 작성한다.

  • Parent wiki page: 드롭다운 메뉴에서 상위 페이지를 선택할 수 있다. 이는 위키의 계층 구조를 만드는 핵심 기능으로, 특정 페이지 아래에 하위 페이지로 배치할 수 있다.3

  • Comment: 페이지 생성 또는 수정 시 변경 사항에 대한 요약을 남길 수 있다. 이 코멘트는 버전 히스토리에 기록되어 변경 내역을 추적하는 데 매우 중요한 역할을 한다.3

모든 내용을 입력한 후 Save 버튼을 클릭하여 페이지 생성을 완료한다.

2.2 기존 페이지 편집 및 제목 변경

기존 페이지의 내용을 수정하려면 해당 페이지로 이동한 뒤 우측 상단의 Edit 버튼을 클릭한다.3 페이지 제목을 변경하는 것 또한 동일한 방식으로 이루어진다.

Edit 모드로 진입한 후, 제목 입력 필드의 텍스트를 수정하고 Save 버튼을 누르면 페이지 이름이 변경된다.3

OpenProject 편집기는 사용자 편의를 위해 로컬 자동 저장 기능을 지원한다. 만약 기술적인 문제나 사용자의 실수로 페이지를 저장하지 못하고 벗어났을 경우, 편집기 툴바를 통해 마지막으로 저장되지 않은 변경 내용을 복구할 수 있다.3

2.3 페이지 변경 내역(History) 추적 및 버전 비교

OpenProject 위키의 가장 강력한 기능 중 하나는 모든 변경 사항을 기록하고 비교할 수 있는 버전 관리 시스템이다. 이는 마치 소프트웨어 개발에서 Git과 같은 버전 제어 시스템을 사용하는 것과 유사하며, 문서의 변경 과정을 투명하게 추적하고 신뢰성을 보장한다.

페이지의 변경 내역을 확인하려면 More > History 메뉴로 이동한다.4 히스토리 화면에서는 각 버전별 수정자, 수정 일시, 그리고 수정 시 남긴 코멘트 목록을 확인할 수 있다.4 특정 두 버전을 선택한 후 View differences 버튼을 클릭하면, 두 버전 간의 차이점을 시각적으로 보여주는 ‘diff’ 화면으로 이동한다. 이 화면에서는 추가된 내용과 삭제된 내용이 명확하게 하이라이트되어 어떤 부분이 변경되었는지 쉽게 파악할 수 있다.4

참고로, 동일한 사용자가 5분 이내에 여러 번 수정할 경우, 해당 변경 사항들은 하나의 히스토리 항목으로 자동 병합된다. 이는 불필요하게 많은 버전 기록이 쌓이는 것을 방지하여 히스토리를 깔끔하게 유지하는 데 도움을 준다.4

2.4 페이지 잠금(Lock) 및 잠금 해제

여러 사용자가 동시에 중요한 문서를 편집할 때 발생할 수 있는 충돌을 방지하기 위해 페이지 잠금 기능을 사용할 수 있다. 페이지를 잠그려면 More > Lock 메뉴를 선택한다.4 페이지가 잠기면 다른 사용자들은 해당 페이지를 편집할 수 없게 된다.

편집을 다시 허용하려면 페이지를 잠근 사용자나 관리자가 More > Unlock 메뉴를 선택하여 잠금을 해제해야 한다.4 이 기능은 중요한 정책 문서나 최종 확정된 명세서를 보호하는 데 유용하다.

2.5 페이지 삭제 및 내보내기

  • 삭제: 더 이상 필요 없는 페이지는 More > Delete 메뉴를 통해 삭제할 수 있다. 삭제 시 확인 창이 나타나며, 한번 삭제된 페이지는 시스템 내에서 쉽게 복원할 수 없으므로 신중해야 한다.4

  • 내보내기: 위키 페이지의 내용을 백업하거나 다른 시스템으로 이전하기 위해 내보내기 기능을 사용할 수 있다. More > Export 메뉴를 선택하면 Atom 또는 Markdown 형식으로 페이지를 내보낼 수 있다.4 이는 프로젝트 간 콘텐츠를 마이그레이션하는 공식적인 방법이다.

3. 콘텐츠 작성 및 서식 지정

OpenProject 위키의 콘텐츠 작성 환경은 최신 웹 기술을 기반으로 하여 사용자에게 직관적이면서도 강력한 편집 경험을 제공한다.

3.1 기술 전환: Textile에서 CKEditor5와 GFM으로

과거 OpenProject 버전은 Textile이라는 마크업 언어를 사용했다.5 하지만 OpenProject 8.0 버전부터는 최신 WYSIWYG(What You See Is What You Get) 편집기인 CKSource CKEditor5를 표준으로 채택했다.1 이 편집기는 내부적으로 GitHub-Flavored Markdown (GFM) 형식을 사용하여 콘텐츠를 저장하고 렌더링한다.1

이러한 기술 전환은 개발자 커뮤니티에서 널리 사용되는 GitHub의 문서 작성 방식과 표준을 맞춤으로써, 기술 사용자들에게 매우 친숙한 환경을 제공한다. 기존의 Textile 기반 콘텐츠는 시스템 업그레이드 시 GFM으로 자동 마이그레이션되므로, 사용자는 새로운 표준에만 집중하면 된다.1 이 가이드는 현재의 GFM 기반 편집기를 기준으로 모든 기능을 설명한다.

3.2 기본 텍스트 서식

편집기 상단의 툴바를 통해 다양한 텍스트 서식을 직관적으로 적용할 수 있다. 지원되는 기본 서식은 굵게, 기울임, 취소선, 인라인 코드, 그리고 > 블록 인용 등이다.1 또한, 드롭다운 메뉴를 통해 여러 수준의 제목(H1, H2, H3 등)을 적용할 수 있다.

CKEditor5는 자동 서식 변환 기능도 지원한다. 예를 들어, **텍스트**라고 입력하면 자동으로 굵은 텍스트로 변환되고, *텍스트*는 기울임꼴로, 줄 시작 부분에 #이나 ##를 입력하면 해당 수준의 제목으로 자동 변환된다.1

기능 (Feature)Markdown 구문 (Syntax)
제목 1 (Header 1)# 제목
굵게 (Bold)**텍스트** or __텍스트__
기울임 (Italic)*텍스트* or _텍스트_
취소선 (Strikethrough)~~텍스트~~
인라인 코드 (Inline Code)코드
링크 (Link)[링크 텍스트](http://url.com)
이미지 (Image)![대체 텍스트](image.jpg)
블록 인용 (Blockquote)> 인용문
순서 없는 목록 (Unordered List)- 항목 or * 항목
순서 있는 목록 (Ordered List)1. 항목

3.3 목록 및 링크

  • 글머리 기호 목록: 줄의 시작에 * 또는 -를 입력하고 한 칸 띄우면 순서 없는 목록이 생성된다.1

  • 번호 매기기 목록: 줄의 시작에 1. 또는 1)을 입력하고 한 칸 띄우면 순서 있는 목록이 생성된다.1

  • 하이퍼링크: 텍스트를 선택한 후 툴바의 링크 아이콘을 클릭하거나, 키보드 단축키 CTRL+k를 사용하여 링크를 삽입할 수 있다.1 외부 URL뿐만 아니라 OpenProject 내의 다른 리소스로도 연결할 수 있다. 특히

#를 입력하면 작업 패키지를, @를 입력하면 사용자를 자동 완성으로 찾아 연결하는 기능이 제공되어 매우 편리하다.6

3.4 이미지 및 파일 첨부

위키 페이지에 이미지를 첨부하는 방법은 세 가지가 있다.1

  1. 툴바의 이미지 아이콘을 클릭하여 파일을 업로드한다.

  2. 클립보드에 복사된 이미지를 편집기에 직접 붙여넣기한다.

  3. 이미지 파일을 편집기 영역으로 드래그 앤 드롭한다.

업로드된 이미지는 페이지의 첨부 파일로 저장되며, 편집기 내에서 이미지의 모서리를 드래그하여 크기를 직관적으로 조절할 수 있다.6

3.5 표(Table) 작성 및 스타일링

툴바의 표 생성 버튼을 사용하여 쉽게 표를 만들 수 있다. 편집기는 행과 열을 추가하거나 삭제하는 직관적인 인터페이스를 제공한다. GFM 표준에 따라, 생성된 모든 표는 헤더(header) 행을 필수로 가진다.1

OpenProject 10.6 버전부터는 표에 대한 고급 스타일링 옵션이 추가되었다.7 사용자는 셀의 배경색, 표의 격자 색상, 셀 내부 여백(padding), 텍스트 정렬, 그리고 긴 단어에 대한 줄바꿈 처리 규칙 등을 세밀하게 조정할 수 있어, 가독성 높은 복잡한 표를 디자인하는 것이 가능하다.

3.6 코드 블록 및 구문 강조

기술 문서에서 가장 중요한 요소 중 하나인 코드 블록은 OpenProject에서 특별한 방식으로 처리된다. CKEditor5 자체는 코드 블록 편집을 기본적으로 지원하지 않지만, OpenProject는 이를 CodeMirror라는 전문 코드 편집기를 통합하여 해결했다.1

사용자가 코드 블록을 편집하려고 하면, 구문 강조(syntax highlighting) 기능이 완벽하게 지원되는 별도의 편집 창이 나타난다.1 이 방식은 개발자에게 익숙하고 편리한 코드 편집 환경을 제공하려는 OpenProject의 세심한 배려를 보여준다. 비록 편집 방식이 이원화되어 있지만, 결과적으로는 일반 텍스트 영역보다 훨씬 뛰어난 코드 가독성과 편집 경험을 제공한다.

4. 위키 구조화 및 탐색

개별 위키 페이지들을 체계적으로 구조화하고 쉽게 탐색할 수 있도록 만드는 것은 지식 베이스의 활용도를 결정하는 중요한 요소다. OpenProject는 이를 위해 두 가지 차원의 정보 아키텍처 설계 도구를 제공한다.

4.1 계층 구조 만들기: 상위-하위 페이지 관계 설정

위키 내부의 정보를 체계적으로 정리하는 가장 기본적인 방법은 페이지 간의 상위-하위 관계를 설정하는 것이다. 페이지를 생성하거나 편집할 때 Parent page 드롭다운 메뉴에서 상위 페이지를 지정하면, 해당 페이지는 선택된 상위 페이지의 하위 항목으로 자동으로 배치된다.3

이렇게 설정된 계층 구조는 좌측의 위키 메뉴에 그대로 반영되어, 사용자들이 마치 파일 탐색기처럼 직관적으로 문서를 탐색할 수 있게 해준다. 특정 상위 페이지를 지정하지 않고 “– No parent page –“를 선택하면 해당 페이지는 최상위 레벨에 위치하게 된다.3 각 계층 내의 페이지들은 알파벳순으로 자동 정렬된다.

4.2 페이지 목차(Table of Contents) 자동 생성 및 활용

내용이 긴 기술 문서의 가독성을 높이기 위해 페이지 내 목차를 자동으로 생성할 수 있다. 페이지의 원하는 위치에 {{toc}} 매크로를 삽입하면, OpenProject가 해당 페이지에 사용된 제목(H1, H2, H3 등)들을 자동으로 분석하여 링크가 포함된 목차를 생성해준다.1

이는 사용자가 문서의 특정 섹션으로 빠르게 이동할 수 있도록 돕는 필수적인 기능이다. 일부 시스템 뷰에서는 전체 위키의 구조를 보여주는 전역 목차(Table of Contents)가 사이드바에 표시되기도 한다.5

4.3 프로젝트 메뉴에 위키 페이지 추가: 바로가기 생성 및 관리

위키 내부의 계층 구조와는 별개로, 특별히 중요한 페이지는 프로젝트의 주 탐색 메뉴에 직접 추가하여 모든 팀원의 접근성을 극대화할 수 있다. 예를 들어, ‘프로젝트 개요’, ‘API 명세서’, ’배포 절차’와 같은 핵심 문서는 이 기능을 통해 최상위 메뉴 항목으로 만들 수 있다.

이 기능을 설정하려면, 해당 위키 페이지에서 More > Configure menu item을 선택한다.9 여기에서 다음과 같은 세 가지 가시성 옵션을 설정할 수 있다 5:

  • Do not show this wikipage in the project navigation: 기본값으로, 페이지는 위키 모듈 내에서만 접근 가능하다.

  • Show as menu item in project navigation: 페이지를 프로젝트 주 메뉴의 독립적인 최상위 항목으로 추가한다.

  • Show as submenu item of …: 페이지를 기존의 다른 메뉴 항목의 하위 메뉴로 추가한다.

또한, 메뉴에 표시될 이름은 실제 위키 페이지 제목과 다르게 간결하게 지정할 수 있어, 탐색 메뉴를 깔끔하게 유지할 수 있다.9 이처럼 OpenProject는 위키 내부의 정교한 구조화(organization)와 외부로의 핵심 정보 노출(discoverability)을 위한 이중 시스템을 제공하여, 방대한 지식 베이스와 핵심 정보 대시보드의 역할을 동시에 수행할 수 있도록 설계되었다.

5. 고급 기능: 매크로 활용

OpenProject 위키의 진정한 강력함은 정적인 문서를 넘어, 프로젝트의 다른 부분과 실시간으로 연동되는 동적 콘텐츠를 삽입할 수 있는 매크로 기능에서 나온다. 매크로를 활용하면 위키 페이지를 단순한 정보 저장소가 아닌, 살아있는 프로젝트 대시보드로 탈바꿈시킬 수 있다.

5.1 OpenProject 매크로의 개념과 삽입 방법

매크로는 위키 페이지나 다른 텍스트 편집 필드에 동적인 정보나 기능을 삽입하는 데 사용되는 특별한 코드 조각이다.10 편집기 툴바의 매크로 삽입 버튼({ })을 통해 사용할 수 있다.6

편집 모드에서는 매크로가 이름이 적힌 플레이스홀더(placeholder) 형태로 표시되지만, 페이지를 저장하고 조회 모드로 전환하면 해당 위치에 실제 동적 콘텐츠가 렌더링된다.1

매크로 (Macro)설명 (Description)주요 설정 (Key Settings)
Table of contents현재 페이지의 제목(H1, H2…)을 기반으로 목차를 자동 생성한다.없음
Embed work package table필터링 및 서식이 지정된 작업 패키지 목록 또는 간트 차트를 동적으로 삽입한다.열, 필터, 그룹화, 정렬 기준
Work package button특정 유형의 새 작업 패키지를 생성하는 양식으로 연결되는 버튼을 만든다.작업 패키지 유형, 버튼 텍스트
Links to child pages현재 페이지의 모든 하위 페이지 목록을 계층적으로 표시한다.없음
Include wiki page다른 위키 페이지의 전체 내용을 현재 페이지에 삽입한다.포함할 위키 페이지 이름

5.2 동적 콘텐츠 삽입: 작업 패키지 테이블 및 간트 차트

가장 강력하고 유연한 매크로는 작업 패키지 테이블을 삽입하는 기능이다.1 이 매크로를 삽입하면, 작업 패키지 모듈에서 사용하는 것과 동일한 설정 창이 나타난다. 사용자는 이 창에서 표시할 열, 필터 조건, 그룹화 기준, 정렬 순서 등을 매우 상세하게 지정할 수 있다.1

이렇게 삽입된 테이블은 단순한 스크린샷이 아니라, 항상 최신 데이터를 동적으로 불러와 표시한다. 또한, 현재 페이지를 보고 있는 사용자의 권한을 존중하여, 해당 사용자가 볼 수 없는 작업 패키지는 테이블에 표시되지 않는다.1 이 기능을 활용하면 ‘이번 스프린트의 미해결 버그 목록’, ‘내가 담당하는 모든 작업’, ‘마일스톤별 진행 상황’ 등 맞춤형 보고서를 위키 페이지에 쉽게 구현할 수 있다. 동일한 방식으로 간트 차트 뷰를 삽입하는 것도 가능하다.6

5.3 사용자 편의성 향상: ‘작업 패키지 생성’ 버튼

이 매크로는 사용자가 특정 유형의 작업 패키지를 쉽게 생성할 수 있도록 돕는 버튼이나 링크를 페이지에 추가한다.1 예를 들어, 버그 리포팅 가이드 페이지에 ‘새 버그 리포트 생성’ 버튼을 추가할 수 있다. 이 버튼은 클릭 시 ‘버그’ 유형이 미리 선택된 작업 패키지 생성 화면으로 사용자를 바로 안내하여, 반복적인 작업을 줄이고 업무 흐름을 간소화한다.1

5.4 콘텐츠 재사용: 다른 위키 페이지 내용 포함하기

include wiki page 매크로는 하나의 위키 페이지 내용을 다른 페이지에 그대로 삽입하는 기능을 제공한다.6 이는 여러 페이지에서 공통적으로 사용되는 안내문, 연락처 정보, 법적 고지 사항 등을 하나의 페이지에서 관리하고 여러 곳에서 재사용할 때 매우 유용하다. 원본 페이지만 수정하면 해당 페이지를 포함하는 모든 페이지의 내용이 자동으로 업데이트되므로, 정보의 일관성을 유지하기 쉽다.

6. 기술 문서 작성을 위한 특수 서식

OpenProject 위키는 GFM을 기반으로 하므로, 복잡한 기술 문서, 특히 수학적 또는 과학적 표기법이 포함된 문서를 작성하는 데 필요한 특수 서식을 지원할 수 있는 잠재력을 가지고 있다.

6.1 LaTeX를 이용한 수학 수식 작성

현재 OpenProject의 CKEditor5에는 MathType이나 MathJax와 같은 수학 수식 편집 플러그인이 공식적으로 활성화되어 있지 않다.13 이는 커뮤니티에서 오랫동안 요청되어 온 기능이다.14

하지만 위키의 근간이 되는 GFM은 GitHub에서 MathJax를 통해 LaTeX 형식의 수학 수식을 렌더링하는 것을 표준으로 지원한다.16 따라서 OpenProject의 편집기에는 별도의 UI가 없더라도, 표준 GFM LaTeX 문법에 따라 수식을 작성하면 렌더러가 이를 올바르게 해석하고 표시할 가능성이 매우 높다. 이는 편집기의 기능과 렌더링 엔진의 기능이 분리되어 있기에 가능한 일이다. 기술 문서를 작성하는 사용자는 다음 표준 문법을 따라야 한다.

  • 인라인 수식 (Inline Expressions): 문장 내에 수식을 포함할 때는 수식을 단일 달러 기호($)로 감싼다.16

  • 예시: 피타고라스 정리는 a2+b2=c2 이다.

  • 블록 수식 (Block Expressions): 수식을 별도의 줄에 중앙 정렬하여 표시하려면, 이중 달러 기호($$)로 감싸거나 math 언어 식별자를 가진 코드 블록을 사용한다.16

  • $$ 사용 예시:

$$
\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
$$
  • math 코드 블록 사용 예시:

코드 스니펫

x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}

6.2 표(Table) 내에서의 수식 처리

Markdown에서 표를 작성할 때 사용하는 파이프 기호(|)는 LaTeX 수식에서도 조건부 확률이나 절댓값 등을 나타내는 데 사용되므로, 충돌이 발생할 수 있다.18 표의 셀 안에서

| 기호를 그대로 사용하면 Markdown 파서가 이를 열 구분자로 인식하여 표의 구조가 깨지게 된다.

이 문제를 해결하기 위해, LaTeX 수식 환경 내에서는 | 기호 대신 \vert 명령어를 사용해야 한다. \vert는 MathJax 렌더러에 의해 수직선으로 올바르게 렌더링되면서도, Markdown 파서에는 영향을 주지 않는다.20

설명 (Description)올바른 구문 (Correct Syntax)렌더링 결과 (Rendered Output)
조건부 확률 (Conditional Probability)$P(A \vert B)$P(A \vert B)
절댓값 (Absolute Value)$f(x) = \vert x \vert$f(x) = \vert x \vert
종류 (Category)기호 (Symbol)LaTeX 코드 (Code)테이블 내 사용법 (Usage in Tables)
분수 (Fraction)$\frac{a}{b}$\frac{a}{b}$\frac{a}{b}$
제곱근 (Square Root)$\sqrt{x}$\sqrt{x}$\sqrt{x}$
합계 (Summation)$\sum_{i=1}^{n}$\sum_{i=1}^{n}$\sum_{i=1}^{n}$
그리스 문자 (Greek)$\alpha, \beta, \gamma$\alpha, \beta, \gamma$\alpha, \beta$
수직선 (Vertical Bar)$P(A \vert B)$P(A \vert B)** $P(A \vert B)$ (필수: \vert 사용)**
관계 연산자 (Relational)$\leq, \geq, \neq$\leq, \geq, \neq$\leq$

7. 협업 및 버전 관리

7.1 페이지 감시(Watch): 변경 사항에 대한 알림 받기

중요한 문서의 변경 사항을 놓치지 않기 위해 ‘감시(Watch)’ 기능을 사용할 수 있다. 페이지 우측 상단의 Watch 버튼을 클릭하면 해당 페이지를 구독하게 된다.3

페이지를 감시하도록 설정하면, 해당 페이지의 내용이 업데이트될 때마다 사용자의 계정 설정에 따라 이메일 알림을 받게 된다.3 이를 통해 팀원들은 핵심 문서의 변경 사항에 대해 항상 최신 정보를 유지할 수 있다. 감시를 중단하려면 동일한 버튼을 다시 클릭하면 된다.

7.2 프로젝트 간 위키 페이지 복사 및 마이그레이션

OpenProject에는 위키 페이지를 다른 프로젝트로 직접 복사하는 원클릭 기능은 존재하지 않는다. 공식적으로 지원되는 방법은 수동으로 페이지를 내보내고 가져오는 것이다.5

절차는 다음과 같다.

  1. 원본 프로젝트의 위키 페이지에서 More > Export를 선택하고 Markdown 형식으로 내보낸다.

  2. 내보낸 파일의 원본 Markdown 텍스트 전체를 복사한다.

  3. 대상 프로젝트에서 새 위키 페이지를 생성한다.

  4. 편집기 창에 복사한 Markdown 텍스트를 붙여넣고 저장한다.

이 방법은 텍스트 기반 콘텐츠를 이전하는 데는 효과적이지만, 한 가지 중요한 제약이 있다. 이미지나 파일과 같은 첨부 파일은 이 과정을 통해 자동으로 이전되지 않으므로, 수동으로 다시 업로드해야 한다.5 이는 각 프로젝트의 위키가 독립적인 개체로 관리된다는 시스템의 설계를 반영한다.

7.3 자주 묻는 질문(FAQ) 및 문제 해결

  • 문제: “위키 페이지를 만들었는데 어디에서도 찾을 수 없다.”

  • 해결책: 해당 페이지가 프로젝트 메뉴에 표시되지 않도록 설정되었을 수 있다. 먼저 위키 모듈 자체의 전체 목차(Table of Contents)를 확인하거나, 페이지의 URL을 직접 입력하여 접근해본다. URL 형식은 [도메인]/projects/[프로젝트 식별자]/wiki/[페이지 이름]이다.5 페이지에 접근한 후

Configure menu item 옵션을 사용하여 메뉴에 표시되도록 설정을 변경할 수 있다.

  • 문제: “프로젝트 메뉴에 위키 모듈이 보이지 않는다.”

  • 해결책: 위키 모듈이 활성화되지 않은 상태다. Project settings > Modules로 이동하여 위키 모듈을 활성화해야 한다.3

8. 참고 자료

  1. Wiki - OpenProject, https://www.openproject.org/docs/user-guide/wiki/
  2. User guide - OpenProject, https://www.openproject.org/docs/user-guide/
  3. Create and edit a wiki page - OpenProject, https://www.openproject.org/docs/user-guide/wiki/create-edit-wiki/
  4. More Wiki functions - OpenProject, https://www.openproject.org/docs/user-guide/wiki/more-wiki-functions/
  5. Frequently asked questions (FAQ) for wiki - OpenProject, https://www.openproject.org/docs/user-guide/wiki/wiki-faq/
  6. Rich text (WYSIWYG) editor in OpenProject, https://www.openproject.org/docs/user-guide/wysiwyg/
  7. improved table formatting, quicker time logging, support of Slovenian language - OpenProject 10.6, https://www.openproject.org/blog/openproject-10-6-release/
  8. Table of Contents | Demo project - OpenProject, https://gpi2.tphon.coecis.cornell.edu/projects/demo-project/wiki/wiki/toc
  9. Wiki project menu - OpenProject, https://www.openproject.org/docs/user-guide/wiki/wiki-menu/
  10. How to save time by using macros in OpenProject’s editors, https://www.openproject.org/blog/how-to-use-macros/
  11. Work package table configuration - OpenProject, https://www.openproject.org/docs/user-guide/work-packages/work-package-table-configuration/
  12. Wiki | OpenProject, https://iop.informatik.uni-bremen.de/projects/demo-project/wiki/wiki
  13. Maths in wiki? - OpenProject Community, https://community.openproject.org/topics/8188
  14. Feature #35539: Mathematical equations in wiki pages - OpenProject Community, https://community.openproject.org/work_packages/35539
  15. Math (mathjax) support for the wiki - OpenProject Community, https://community.openproject.org/topics/10984
  16. Writing mathematical expressions - GitHub Docs, https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions
  17. Math support in Markdown - The GitHub Blog, https://github.blog/news-insights/product-news/math-support-in-markdown/
  18. What is the correct way to use a pipe (|) in an inline code block in a table in Markdown? - Stack Overflow, https://stackoverflow.com/questions/75195342/what-is-the-correct-way-to-use-a-pipe-in-an-inline-code-block-in-a-table-in
  19. How can I use the pipe (|) symbol in a table? - Meta Stack Exchange, https://meta.stackexchange.com/questions/359349/how-can-i-use-the-pipe-symbol-in-a-table
  20. Help adding a vertical line ‘|’ - LaTeX.org, https://latex.org/forum/viewtopic.php?t=6000
  21. Vertical bar symbol within a markdown table - Stack Overflow, https://stackoverflow.com/questions/49809122/vertical-bar-symbol-within-a-markdown-table