AiGarden/WikiAuthoring
MoinMoin wiki 콘텐츠 생성과 관리를 위한 가이드라인과 도구들.
Contents
Core Principles
MoinMoin Wiki Markup - 마크다운이 아닌 MoinMoin wiki 마크업 구문을 사용하라:
= Heading 1 =
== Heading 2 ==
'''bold'''와 ''italic''
내부 링크는 [[PageName]]
외부 링크는 [http://example.com Link Text]
Local First, Then Upload - 먼저 로컬 파일에서 콘텐츠를 생성하고 편집하라. wiki 서버에 업로드하기 전에 로컬에서 검토하고 개선하라. cat filename.txt | moin put PageName을 사용해서 콘텐츠를 업로드하라.
Follow Wiki Conventions - 기존 페이지 명명 규칙을 사용하라 (CamelCase 또는 관찰된 특정 패턴들). [[PageName]]을 사용해서 기존 관련 페이지들을 참조하라. 향후 콘텐츠를 계획할 때 존재하지 않는 페이지들에 링크하라. 기존 wiki 콘텐츠와 일관된 구조를 유지하라.
Content Organization - 구조적 패턴을 위해 기존 페이지들을 연구하라. 적절한 분류를 사용하라 (예: CategoryPattern, CategoryBook). 관련 개념과 페이지들을 상호 참조하라. 논리적 계층과 관계를 유지하라.
Available Commands
# 인증과 설정 moin auth # 초기 설정과 인증 # 콘텐츠 작업 moin get PageName # 페이지 콘텐츠 다운로드 moin put PageName file.txt # 파일에서 콘텐츠 업로드 cat file.txt | moin put PageName # stdin에서 콘텐츠 업로드 (권장) moin list # 모든 페이지 목록 moin search "query" # 페이지 검색 moin recent N # 지난 N일 동안 변경된 페이지 표시
Workflow
Research - moin list와 moin search를 사용해서 기존 콘텐츠를 이해하라.
Draft - MoinMoin 마크업으로 로컬 파일을 생성하라.
Review - 로컬에서 마크업과 콘텐츠 구조를 검증하라.
Upload - cat file.txt | moin put PageName을 사용해서 wiki 서버에 게시하라.
Verify - wiki 서버에서 게시된 콘텐츠를 확인하라.
MoinMoin Markup Reference
Basic Formatting
= Main Heading = == Sub Heading == === Sub-sub Heading === '''Bold text''' ''Italic text'' `Monospace text`
Links
[[InternalPageLink]] [[PageName|Display Text]] [http://example.com External Link]
Lists
중요: MoinMoin에서는 불릿 포인트에 *만 사용하고, -는 사용하지 않는다. 반드시 앞에 공백을 넣어야 한다.
* Bullet list item * Another item * Nested item (더 많은 공백으로 중첩) 1. Numbered list 2. Another item 1. Nested numbered item
Code and Preformatted Text
Inline `code` with backticks
{{{
Code block or preformatted text
Multiple lines supported}}}
Tables
||Cell 1||Cell 2|| ||Cell 3||Cell 4||
Other Elements
---- (horizontal rule) <<TableOfContents(2)>> (table of contents, depth 2)
Common Mistakes
Broken Bullet Points - - 대신 * 사용해야 함. 공백 없이 시작하면 렌더링되지 않음.
# 잘못된 예 - Item 1 * Item 2 (공백 없음) # 올바른 예 * Item 1 * Item 2
WikiLinks in Headings - 헤딩 안에 wikilink를 넣으면 제대로 렌더링되지 않음.
# 잘못된 예 == [[SomePage]] == # 올바른 예 == Some Topic == [[SomePage]] - 관련 페이지 설명
Code Block Syntax - 마크다운 스타일 가 아닌 `를 사용해야 함.
Style Guidelines
Story-First Approach - 이솝우화처럼 기억에 남는 이야기 구조를 사용하라. 불릿 포인트보다는 자연스러운 문단을 활용하라. 은유와 구체적 캐릭터를 통해 추상적 개념을 설명하라.
Educational Focus - 초보자들이 이해하고 적용할 수 있도록 풍부한 설명, 예시, 은유, 우화를 포함하라. 단순한 규칙이 아닌 왜 그런지에 대한 통찰을 제공하라.
Pattern Connections - 각 페이지가 다른 페이지들과 의미있게 연결되도록 하라. Related Patterns, See Also 섹션을 활용해서 지식 네트워크를 구축하라.
Maintenance Tips
Regular Syntax Check - 새 페이지를 만들 때마다 기본 마크업이 제대로 렌더링되는지 확인하라.
Link Validation - 내부 링크들이 올바르게 작동하는지 주기적으로 점검하라.
Category Management - 적절한 CategoryXXX 태그를 추가해서 페이지 분류를 명확히 하라.