가온 위키 - 사용자 기여 [ko]

가온 위키:대문

2026-07-10T02:46:45Z

Admin: 대문 업데이트

__NOTOC__ __NOEDITSECTION__


<div style="text-align: center; padding: 2em 1em; background-color: #f8f9fa; border: 1px solid #e1e8ed; margin-bottom: 20px;">
<span style="font-size: 180%; font-weight: bold; color: #2c3e50;">가온 위키 베타에 오신 것을 환영합니다</span><br>
<span style="font-size: 110%; color: #7f8c8d;">누구나 자유롭게 기여하고 공유할 수 있는 지식 저장소</span>
</div>


<div style="display: flex; flex-wrap: wrap; gap: 20px; align-items: flex-start;">


<div style="flex: 1 1 320px; min-width: 0;">


<div style="border: 1px solid #e1e8ed; padding: 15px; background: #ffffff; margin-bottom: 15px;">
<h2 style="margin-top: 0; border-bottom: 2px solid #3498db; font-size: 130%;">📢 공지사항</h2>
* [https://www.gaonwiki.com/w/리버티_스킨 리버티 스킨]이 무겁고 비효율적으로 동작하기에 대폭 개선한 [https://www.gaonwiki.com/w/Whale_스킨 Whale 스킨]을 개발 및 테스트 중입니다.
* 기능 추가나 버그 수정 요청은 언제든 환영입니다! [https://bbs.gaonwiki.com/issue 가온 위키 커뮤니티 - 이슈 트래커]를 통해 알려주세요.
</div>


<div style="border: 1px solid #e1e8ed; padding: 15px; background: #ffffff;">
<h2 style="margin-top: 0; border-bottom: 2px solid #2ecc71; font-size: 130%;">📚 주요 분류</h2>
* [[:분류:소프트웨어|소프트웨어]]
* [[:분류:인공지능|인공지능(AI)]]
* [[:분류:프론트엔드|프론트엔드]]
* [[:분류:운영체제|운영체제]]
* [[:분류:게임|게임]]
</div>

</div>


<div style="flex: 1 1 320px; min-width: 0;">


<div style="border: 1px solid #e1e8ed; padding: 15px; background: #ffffff; margin-bottom: 15px;">
<h2 style="margin-top: 0; border-bottom: 2px solid #9b59b6; font-size: 130%;">🌟 이 사이트는...</h2>
'''[[가온 위키]]'''는 모두가 참여 가능한 위키 사이트입니다!<br><br>
<div style="text-align: right;">[[가온 위키|'''더 읽어보기 ➔''']]</div>
</div>


<div style="border: 1px solid #e1e8ed; padding: 15px; background: #ffffff;">
<h2 style="margin-top: 0; border-bottom: 2px solid #f1c40f; font-size: 130%;">🛠️ 위키 시작하기</h2>
* '''문서 찾기:''' 상단의 검색창을 통해 원하는 지식을 검색하세요.
* '''새 문서 만들기:''' 검색창에 생성하고 싶은 제목을 입력한 후, 붉은색 링크를 클릭하여 작성할 수 있습니다.
* 표 작성, 이미지 삽입 등은 [[도움말:위키 문법]]을 참고하세요.
</div>

</div>

</div>

미디어위키:Whale-Navbar

2026-06-23T12:46:14Z

Admin:

- text: 커뮤니티
link: https://bbs.gaonwiki.com
icon: comments
children:
- text: 위키방
link: https://bbs.gaonwiki.com
title: https://bbs.gaonwiki.com
icon: edit

- text: 자유게시판
link: https://bbs.gaonwiki.com/free
title: https://bbs.gaonwiki.com/free
icon: comment

- text: 저작권 문의
link: https://bbs.gaonwiki.com/copyrights
title: https://bbs.gaonwiki.com/copyrights
icon: lock

- text: 이슈 등록
link: https://bbs.gaonwiki.com/issue
title: https://bbs.gaonwiki.com/issue
icon: plus

- text: 기능 도움 요청
link: https://www.gaonwiki.com/w/가온_위키:기능_구현_불가-누가_해결책을_알려주세요!
title: https://www.gaonwiki.com/w/가온_위키:기능_구현_불가-누가_해결책을_알려주세요!
icon: question

- text: 도구·도움말
link: 특수:특수문서
icon: cog
children:
- text: 특수 문서
link: 특수:특수문서
title: 특수:특수문서
icon: list

- text: 파일 올리기
link: 특수:올리기
icon: upload
children:
- text: 기존 업로드
link: 특수:올리기
title: 특수:올리기
icon: upload

- text: 업로드 마법사
link: 특수:UploadWizard
title: 특수:UploadWizard
icon: image

- text: 알려진 문제
link: https://www.gaonwiki.com/w/가온_위키/알려진_문제들
title: https://www.gaonwiki.com/w/가온_위키/알려진_문제들
icon: info

- text: 베타 위키
link: https://beta.gaonwiki.com
title: https://beta.gaonwiki.com
icon: globe

- text: 위키 문법
link: 도움말:위키_문법
title: 도움말:위키_문법
icon: edit

- text: 설명서
link: 도움말:설명서
title: 도움말:설명서
icon: book

미디어위키:Whale-Navbar

2026-06-23T12:44:53Z

Admin: Whale 스킨 Navbar

* text: 커뮤니티
link: https://bbs.gaonwiki.com
icon: comments
children:

* text: 위키방
link: https://bbs.gaonwiki.com
title: https://bbs.gaonwiki.com
icon: edit

* text: 자유게시판
link: https://bbs.gaonwiki.com/free
title: https://bbs.gaonwiki.com/free
icon: comment

* text: 저작권 문의
link: https://bbs.gaonwiki.com/copyrights
title: https://bbs.gaonwiki.com/copyrights
icon: lock

* text: 이슈 등록
link: https://bbs.gaonwiki.com/issue
title: https://bbs.gaonwiki.com/issue
icon: plus

* text: 기능 도움 요청
link: https://www.gaonwiki.com/w/가온_위키:기능_구현_불가-누가_해결책을_알려주세요!
title: https://www.gaonwiki.com/w/가온_위키:기능_구현_불가-누가_해결책을_알려주세요!
icon: question

* text: 도구·도움말
link: 특수:특수문서
icon: cog
children:

* text: 특수 문서
link: 특수:특수문서
title: 특수:특수문서
icon: list

* text: 파일 올리기
link: 특수:올리기
icon: upload
children:

* text: 기존 업로드
link: 특수:올리기
title: 특수:올리기
icon: upload

* text: 업로드 마법사
link: 특수:UploadWizard
title: 특수:UploadWizard
icon: image

* text: 알려진 문제
link: https://www.gaonwiki.com/w/가온_위키/알려진_문제들
title: https://www.gaonwiki.com/w/가온_위키/알려진_문제들
icon: info

* text: 베타 위키
link: https://beta.gaonwiki.com
title: https://beta.gaonwiki.com
icon: globe

* text: 위키 문법
link: 도움말:위키_문법
title: 도움말:위키_문법
icon: edit

* text: 설명서
link: 도움말:설명서
title: 도움말:설명서
icon: book

Github

2025-11-25T00:19:48Z

Admin: 문서 최신화

[[파일:Font Awesome 5 brands github.svg|100px|섬네일|대체글=깃허브의 로고|깃허브의 로고]]
깃허브(GitHub, 원래 이름: Logical Awesome LLC)는 2008년 4월에 서비스를 시작한, 분산 버전 관리 툴인 깃 저장소 호스팅을 지원하는 웹 기반 소프트웨어 개발 및 협업 플랫폼이다. 깃허브는 깃(Git)을 기반으로 소스 코드 저장·관리, 이슈 추적, 코드 리뷰, 프로젝트 관리, 지속적 통합(CI) 및 배포(CD) 기능을 제공하며, 각 저장소 단위로 위키와 웹 페이지, 패키지 레지스트리 등을 운영할 수 있다.<ref>https://github.com/about 소개 페이지 등</ref> 2018년 6월 4일 마이크로소프트가 깃허브를 약 75억 달러에 인수한다고 발표하고 같은 해 10월 26일 인수를 완료하면서 깃허브는 마이크로소프트의 자회사가 되었으며,<ref>[https://news.microsoft.com/announcement/microsoft-acquires-github]</ref><ref>[https://blogs.microsoft.com/blog/2018/10/26/microsoft-completes-github-acquisition]</ref> 2020년대 중반에는 1억 5,000만 명 이상의 개발자와 10억 개가 넘는 저장소 및 포크를 호스팅하는 세계 최대 규모의 소스 코드 호스팅 서비스로 성장하였다.<ref>[https://github.com/about]</ref><ref>[https://electroiq.com/stats/github-statistics]</ref>

== 역사 ==
=== 설립과 초기 성장 ===
깃허브는 2007년 미국 캘리포니아주 샌프란시스코에서 톰 프레스턴-워너(Tom Preston-Werner), 크리스 완스트라스(Chris Wanstrath), 피제이 하이엣(P. J. Hyett), 스콧 채컨(Scott Chacon) 등이 공동으로 설립하였다. 깃허브닷컴 서비스는 2008년 2월부터 제한적인 형태로 공개되었고, 같은 해 4월 정식으로 서비스를 시작하였다.<ref>[https://pslmodels.github.io/Git-Tutorial/content/background/GitHubHistory.html]</ref> 루비 온 레일스(Ruby on Rails)로 구현된 웹 인터페이스와 깃 기반 분산 버전 관리를 쉽게 사용할 수 있는 점이 알려지면서, 다양한 오픈 소스 프로젝트와 개인 개발자들이 빠르게 유입되었다.

서비스 시작 후 1년이 채 되지 않은 2009년 2월, 깃허브는 4만 6,000개 이상의 공개 저장소와 9만 개에 가까운 고유 공개 저장소를 호스팅하고 있다고 발표했으며, 2010년에는 100만 개, 2011년에는 200만 개 이상의 저장소를 호스팅하는 등 단기간에 대표적인 깃 호스팅 서비스로 성장하였다. 이러한 성장세에 힘입어 깃허브는 2010년대 초반 이후 소스포지(SourceForge), 구글 코드(Google Code) 등을 제치고 가장 널리 사용되는 오픈 소스 소프트웨어 호스팅 플랫폼 가운데 하나가 되었다.

=== 투자 유치와 기업 성장 ===
깃허브는 초기에는 비교적 적은 외부 자본으로 운영되었으나, 2012년 안드리센 호로위츠(Andreessen Horowitz) 등으로부터 1억 달러 규모의 투자를 유치하였고, 2015년에는 시콰이어 캐피털(Sequoia Capital)이 주도한 시리즈 B 라운드에서 2억 5,000만 달러의 투자를 받으며 기업 가치를 약 20억 달러로 인정받았다. 이후 엔터프라이즈 고객 확대와 유료 요금제 다변화를 통해 수익 구조를 강화하여, 2020년대 초반에는 연 매출 10억 달러 규모의 서비스를 운영하는 기업으로 평가되었다.

=== 마이크로소프트에 의한 인수 ===
2010년대 중반 이후 마이크로소프트는 .NET, 파워셸(PowerShell), 비주얼 스튜디오 코드(Visual Studio Code), 윈도 계산기, 윈도 터미널 등의 오픈 소스 프로젝트와 제품 문서를 깃허브에 공개하는 등 주요 오픈 소스 활동의 중심을 깃허브로 옮기기 시작하였다. 2018년 6월 4일, 마이크로소프트는 깃허브를 75억 달러 규모의 자사 주식으로 인수할 계획이라고 공식 발표했으며,<ref>[https://news.microsoft.com/announcement/microsoft-acquires-github]</ref> 같은 해 10월 26일 인수 절차가 마무리되었다.<ref>[https://blogs.microsoft.com/blog/2018/10/26/microsoft-completes-github-acquisition]</ref> 인수 이후에도 깃허브는 독립된 브랜드와 제품 철학을 유지하는 자회사 형태로 운영되었고, 자마린(Xamarin)의 전 최고경영자였던 낫 프리드먼(Nat Friedman)이 깃허브의 최고경영자(CEO)를 맡았다.<ref>[https://www.theverge.com/2018/10/26/17954714/microsoft-github-deal-acquisition-complete]</ref>

인수 발표 당시 일부 개발자와 오픈 소스 커뮤니티에서는 마이크로소프트의 과거 인수 사례와 폐쇄적인 소프트웨어 전략을 이유로 우려를 표하기도 하였으나, 마이크로소프트는 깃허브를 오픈 소스 친화적인 플랫폼으로 유지하겠다고 강조하였다. 인수 이후에도 깃허브는 리눅스 커널, 파이썬, Node.js 등 주요 오픈 소스 프로젝트의 핵심 호스팅 플랫폼 역할을 계속 수행하고 있다.

=== AI 중심 전략과 조직 개편 ===
2020년대에 들어서면서 깃허브는 AI 기반 개발 도구인 깃허브 코파일럿(GitHub Copilot)을 핵심 서비스 가운데 하나로 육성하였다. 코파일럿은 2021년 공개 프리뷰를 시작으로, 2020년대 중반에는 수천만 명의 사용자를 확보하며 대표적인 AI 코딩 도우미로 자리 잡았다.<ref>[https://github.com/features/copilot]</ref><ref>[https://docs.github.com/en/copilot/get-started/what-is-github-copilot]</ref>

2025년 8월, 깃허브 CEO 토마스 돔케(Thomas Dohmke)가 사임 의사를 밝히면서 마이크로소프트는 깃허브 CEO 직책을 별도로 두지 않고, 깃허브를 자사 코어AI(CoreAI) 조직 아래에 편제하기로 결정하였다.<ref>[https://www.axios.com/2025/08/11/github-ceo-dohmke-step-down]</ref><ref>[https://www.windowscentral.com/microsoft/github-ceo-resigns-ending-independent-operations-as-platform-joins-microsofts-coreai-division]</ref> 이로써 2018년 인수 이후 비교적 독립적으로 운영되던 깃허브는 마이크로소프트의 AI 전략과 더 긴밀하게 통합되는 방향으로 재편되었으며, 특히 코파일럿과 관련된 기능 개발과 Azure 클라우드와의 연계가 한층 강화되었다.

같은 시기 마이크로소프트는 깃허브의 주요 인프라를 자사 클라우드 플랫폼인 애저(Azure)로 단계적으로 이전하겠다고 발표하였다. 이는 코파일럿과 기타 AI 서비스의 연산 수요 증가에 대응하고, 자체 데이터센터 한계를 해소하기 위한 조치로 설명되었다.<ref>[https://www.theverge.com/tech/796119/microsoft-github-azure-migration-move-notepad]</ref>

== 이용 현황 ==
깃허브는 텍스트 파일과 소스 코드의 버전 관리를 위한 표준 플랫폼 가운데 하나로 자리 잡아, 개인 개발자부터 대규모 기업, 오픈 소스 프로젝트, 교육 기관에 이르기까지 폭넓게 사용되고 있다. 2020년대 중반 기준으로 깃허브는 1억 5,000만 명 이상의 개발자 계정을 보유하고 있으며, 공개·비공개 저장소와 포크를 합쳐 10억 개가 넘는 프로젝트를 호스팅하는 것으로 알려져 있다.<ref>[https://github.com/about]</ref><ref>[https://electroiq.com/stats/github-statistics]</ref><ref>[https://github.blog/news-insights/octoverse/octoverse-a-new-developer-joins-github-every-second-as-ai-leads-typescript-to-1]</ref> 깃허브의 연례 통계 보고서인 옥토버스(Octoverse)에 따르면, 매초마다 새로운 개발자가 깃허브에 가입하고 있으며, 타입스크립트(TypeScript)와 같은 정적 타입 언어와 AI 관련 프로젝트의 비중이 빠르게 증가하고 있다.<ref>[https://octoverse.github.com]</ref>

또한, 깃허브는 수많은 오픈 소스 프로젝트뿐만 아니라, 기업 내부의 비공개 코드 저장소 관리와 협업 도구로도 사용되고 있으며, 교육용으로 학생 및 강의용 저장소를 제공하는 깃허브 에듀(GitHub Education) 프로그램도 운영하고 있다.

== 서비스와 기능 ==
=== 저장소와 버전 관리 ===
깃허브의 핵심 기능은 깃 저장소를 호스팅하고, 이를 웹 인터페이스 및 API를 통해 관리하는 것이다. 사용자는 명령줄 인터페이스(CLI)나 데스크톱 클라이언트, 통합 개발 환경(IDE)의 플러그인 등을 사용하여 저장소를 클론(clone)하고, 변경 사항을 커밋(commit)·푸시(push)·풀(pull)하는 일반적인 깃 작업을 수행할 수 있다. 깃허브는 브랜치, 포크(fork), 풀 리퀘스트(pull request) 등의 깃 개념을 시각적으로 표현하는 웹 UI를 제공하여 코드 리뷰와 협업을 돕는다.

각 저장소는 접근 권한 설정을 통해 공개 저장소, 비공개 저장소, 조직(organization) 단위 저장소 등으로 구분할 수 있으며, 팀과 조직은 역할 기반 권한 관리 기능을 이용하여 세밀한 협업 구조를 구성할 수 있다.

=== 이슈 추적과 프로젝트 관리 ===
깃허브는 버그 보고, 기능 요청, 작업 항목 등을 관리하기 위한 이슈(issue) 기능을 제공한다. 이슈에는 라벨(label), 마일스톤(milestone), 담당자(assignee), 프로젝트 보드(Project board) 등을 연계할 수 있어, 스크럼이나 칸반과 같은 애자일(Agile) 개발 프로세스를 구현하는 데 활용된다. 또한 프로젝트 단위로 토론(Discussions) 기능을 사용하여 질의응답과 제안, 일반적인 커뮤니티 대화를 나눌 수 있다.

=== 소셜 기능 ===
깃허브는 팔로우(follow), 스타(star), 포크, 활동 피드 등 소셜 네트워크 서비스와 유사한 기능을 제공한다. 사용자는 관심 있는 저장소에 별(★)을 표시하여 북마크할 수 있고, 다른 사용자의 활동을 팔로우하여 새로운 프로젝트와 커밋을 확인할 수 있다. 저장소 간의 포크 관계와 개발자 간의 협업 관계는 소셜 그래프 형태로 시각화할 수 있다.

=== GitHub Pages ===
깃허브 페이지스(GitHub Pages)는 2008년에 도입된 정적 웹 사이트 호스팅 서비스이다. 사용자는 저장소에 마크다운(Markdown)이나 HTML 파일을 추가하여 블로그, 프로젝트 문서, 제품 웹사이트 등을 만들 수 있으며, 깃허브는 이를 github.io 도메인 또는 사용자가 소유한 커스텀 도메인으로 제공한다. 기본적으로 정적 사이트 생성기인 지킬(Jekyll)과 통합되어 저장소의 변경 사항을 자동으로 웹 사이트에 반영하는 기능을 제공한다.

=== Gist ===
지스트(Gist)는 깃허브가 제공하는 페이스트빈(pastebin) 스타일의 코드 스니펫 공유 서비스이다. 각 지스트는 자체적인 깃 저장소로 취급되며, 여러 개의 파일을 포함할 수 있고, 포크와 수정 기록을 지원한다. 2018년 이후에는 스팸 방지를 위해 로그인한 사용자만 새 지스트를 생성할 수 있도록 정책이 변경되었다.

=== GitHub Actions ===
깃허브 액션스(GitHub Actions)는 저장소 내 워크플로 파일을 기반으로 빌드, 테스트, 배포 등 다양한 작업을 자동화할 수 있는 지속적 통합 및 자동화 플랫폼이다. 사용자는 YAML 형식으로 워크플로를 정의하여, 커밋 또는 풀 리퀘스트 생성 시 테스트를 실행하거나, 특정 브랜치에 머지될 때 자동으로 애플리케이션을 배포하는 등의 작업을 수행할 수 있다. 깃허브 마켓플레이스에서는 커뮤니티와 기업이 만든 수많은 액션(Action)을 공유하고 재사용할 수 있다.

=== GitHub Codespaces ===
깃허브 코드스페이스(GitHub Codespaces)는 클라우드 기반 개발 환경을 제공하는 서비스로, 브라우저 또는 지원되는 IDE에서 바로 컨테이너 기반 개발 환경을 실행할 수 있게 해 준다.<ref>[https://github.com/features/codespaces]</ref><ref>[https://docs.github.com/codespaces/overview]</ref> 프로젝트 저장소에 개발 컨테이너(dev container) 설정 파일을 추가해 두면, 팀 구성원은 동일한 환경을 빠르게 생성하여 개발을 시작할 수 있다. 이를 통해 개발 환경 구축에 드는 시간을 줄이고, 교육·워크숍·기여자 온보딩을 단순화할 수 있다.

=== 기타 기능 ===
이 밖에도 깃허브는 패키지 레지스트리 서비스인 깃허브 패키지(GitHub Packages), 모바일 애플리케이션, 개발자 후원을 위한 깃허브 스폰서스(GitHub Sponsors), 코드 검색 및 분석 도구, 조직 단위 감사 로그와 SSO 연동 등 다양한 기능을 제공한다.

== AI 기능: GitHub Copilot ==
깃허브 코파일럿(GitHub Copilot)은 깃허브와 오픈AI가 공동으로 개발한 AI 기반 코딩 보조 도구로, 코드 편집기에서 자연어 설명이나 기존 코드 맥락을 바탕으로 코드 제안을 생성해 주는 서비스이다.<ref>[https://docs.github.com/en/copilot/get-started/what-is-github-copilot]</ref> 초기에는 주로 자동 완성 수준의 기능을 제공했으나, 이후 채팅 인터페이스(Copilot Chat), 음성 입력, 테스트 코드 생성, 보안 취약점 제안 등 기능이 확장되었다.<ref>[https://github.com/features/copilot]</ref>

2025년에 도입된 코파일럿 코딩 에이전트(Copilot coding agent)는 특정 이슈를 할당받아 직접 코드 변경을 수행하고, 풀 리퀘스트를 생성하는 등 보다 자율적인 작업을 지원한다.<ref>[https://docs.github.com/en/copilot/get-started/features]</ref><ref>[https://economictimes.indiatimes.com/tech/artificial-intelligence/github-launches-new-ai-coding-agent-that-fixes-bugs/articleshow/121283818.cms]</ref> 코파일럿은 수백만에서 수천만 명의 개발자가 사용하는 대표적인 AI 프로그래밍 도구로 성장하였으며, 깃허브의 전략에서 핵심적인 위치를 차지하고 있다.<ref>[https://www.windowscentral.com/microsoft/github-ceo-resigns-ending-independent-operations-as-platform-joins-microsofts-coreai-division]</ref>

== 보안 및 품질 관리 ==
깃허브는 저장소의 의존성(Dependencies)을 자동으로 분석하고, 알려진 취약점이 포함된 패키지를 감지하는 디펜더봇(Dependabot)과 정적 분석 엔진인 코드QL(CodeQL)을 제공하여 개발자가 보안 문제를 조기에 발견하도록 돕는다.<ref>[https://github.blog/news-insights/octoverse/octoverse-a-new-developer-joins-github-every-second-as-ai-leads-typescript-to-1]</ref> 2025년 기준으로 수십만 개의 저장소가 디펜더봇을 활성화하여 자동 업데이트와 경고 기능을 사용하고 있으며, 심각한 취약점에 대한 평균 수정 속도도 이전보다 빠르게 개선되고 있다는 통계가 보고되었다.<ref>[https://octoverse.github.com]</ref>

또한 기업 고객을 위해 SAML 기반 싱글 사인온(SSO), 감사 로그, 규정 준수 보고 등 엔터프라이즈 보안 기능을 제공하며, 자체 호스팅 환경을 위한 깃허브 엔터프라이즈 서버(GitHub Enterprise Server) 제품도 운영하고 있다.

== 비판과 논란 ==
=== 직장 내 괴롭힘 논란 ===
2014년, 깃허브의 전 직원이었던 줄리 앤 호바스(Julie Ann Horvath)는 공동 설립자이자 당시 CEO였던 톰 프레스턴-워너와 그의 배우자가 자신의 경력에 부당한 압력을 행사했다고 주장하며 회사를 떠났다. 내부 조사를 통해 프레스턴-워너가 CEO로서 부적절한 행동을 했다는 사실이 확인되었고, 이 사건의 결과로 그는 CEO 자리에서 물러났다. 이후 깃허브는 직장 내 괴롭힘 방지와 직원 보호를 위한 제도 개선을 약속하였다.

=== 검열과 접속 차단 ===
깃허브는 다양한 국가에서 인터넷 검열 및 법적 규제와 관련된 논란을 겪어 왔다. 2014년 러시아는 자살 관련 자료가 게재되었다는 이유로 깃허브 전체 도메인을 일시적으로 차단했다가, 이후 특정 페이지 단위 차단으로 전환하였다. 같은 해 인도 역시 극단주의 단체 관련 콘텐츠를 이유로 깃허브를 포함한 여러 웹사이트를 일시적으로 차단한 바 있다. 또한 2015년에는 중국발로 추정되는 대규모 디도스(DDoS) 공격을 받아, 중국의 인터넷 검열 회피 도구와 관련된 콘텐츠가 공격 대상이 되었을 것이라는 분석이 제기되었다.

=== ICE 계약 논란 ===
2019년, 깃허브가 미국 이민세관단속국(ICE)과의 깃허브 엔터프라이즈 서버 라이선스 계약을 유지한 사실이 알려지면서 내부 직원과 개발자 커뮤니티의 비판을 받았다. 깃허브는 계약 규모가 회사 전체 매출에 비해 크지 않다고 설명하는 한편, 이민자 인권 단체에 추가 기부를 약속했으나, 일부 직원은 이에 반발하여 공개 서한을 발표하고 회사를 떠나기도 했다.

== 같이 보기 ==
* 깃
* 마이크로소프트
* 깃허브 코파일럿
* 오픈 소스 소프트웨어

== 외부 링크 ==
* [https://github.com/ GitHub 공식 웹사이트]
* [https://docs.github.com/ GitHub 공식 문서]
* [https://octoverse.github.com/ GitHub Octoverse]

== 각주 ==
<references />

2025년 11월 Cloudflare Global Network 장애

2025-11-20T23:40:33Z

Admin: 시작

<div style="border: 1px solid #a2a9b1; background-color: #f8f9fa; padding: 10px; margin-bottom: 1em; font-size: 95%;">
'''주의.''' 이 문서는 '''2025년 11월'''에 발생한 특정 사건을 다루고 있습니다. 현재 진행 중인 장애 상황을 확인하려면 [https://www.cloudflarestatus.com/ Cloudflare System Status]를 참조하십시오.
</div>

{| style="float: right; width: 400px; margin: 0 0 1em 1em; border: 1px solid #ddd; border-collapse: collapse; background-color: #fff; font-size: 0.9em; box-shadow: 0 2px 4px rgba(0,0,0,0.1);"
|+ <div style="background: linear-gradient(135deg, #F38020 0%, #faad3f 100%); color: #fff; padding: 10px; font-size: 1.3em; font-weight: bold; border-radius: 5px 5px 0 0;">2025년 11월 Cloudflare Global Network 장애</div>
|-
! colspan="2" style="background-color: #f5f5f5; text-align: center; padding: 5px; border-bottom: 1px solid #ddd; font-size: 0.85em;" | Cloudflare November 2025 Outage
|-
| colspan="2" style="text-align: center; border-bottom: 1px solid #ddd; padding: 10px;" | [[파일:Cloudflare_Logo.png|150px|center|Cloudflare 로고]]<br />'''인터넷의 20%가 사라진 날'''
|-
! style="background-color: #FBC089; color: #222; width: 30%; border-bottom: 1px solid #ddd; padding: 8px; text-align: center;" | 발생 일시
| style="border-bottom: 1px solid #ddd; padding: 8px;" | 2025년 11월 18일 11:20 (UTC)<br />(한국 시간 2025년 11월 18일 20:20)
|-
! style="background-color: #FBC089; color: #222; border-bottom: 1px solid #ddd; padding: 8px; text-align: center;" | 종료 일시
| style="border-bottom: 1px solid #ddd; padding: 8px;" | 2025년 11월 18일 17:06 (UTC)<br />(한국 시간 2025년 11월 19일 02:06)
|-
! style="background-color: #FBC089; color: #222; border-bottom: 1px solid #ddd; padding: 8px; text-align: center;" | 지속 시간
| style="border-bottom: 1px solid #ddd; padding: 8px;" | 약 5시간 46분
|-
! style="background-color: #FBC089; color: #222; border-bottom: 1px solid #ddd; padding: 8px; text-align: center;" | 심각도
| style="border-bottom: 1px solid #ddd; padding: 8px; background-color: #ffcccc; color: #d33;" | '''Critical (P0)'''
|-
! style="background-color: #FBC089; color: #222; border-bottom: 1px solid #ddd; padding: 8px; text-align: center;" | 발생 원인
| style="border-bottom: 1px solid #ddd; padding: 8px;" | 봇 관리(Bot Management) 구성 파일 생성 로직 오류<br />및 배포 파이프라인 검증 실패
|-
! style="background-color: #FBC089; color: #222; border-bottom: 1px solid #ddd; padding: 8px; text-align: center;" | 피해 대상
| style="border-bottom: 1px solid #ddd; padding: 8px;" | Cloudflare CDN/WAF 이용 고객 전체<br />(전 세계 인터넷 트래픽의 약 20% 영향)
|-
! style="background-color: #FBC089; color: #222; padding: 8px; text-align: center;" | 상태
| style="padding: 8px;" | '''해결됨 (Resolved)'''
|}

== 개요 ==
{{인용문|'''"This was a self-inflicted wound."'''<br> (이것은 우리 스스로 자초한 상처였습니다.)|''Cloudflare 공식 사후 분석 보고서(Post-mortem) 中''}}

'''2025년 11월 Cloudflare Global Network 장애'''는 2025년 11월 18일(한국 시간 기준 오후 8시 20분), 전 세계 최대의 [[CDN]] 및 보안 기업인 [[Cloudflare]]의 글로벌 네트워크 전체가 마비된 대규모 인터넷 서비스 장애 사건이다.

단순한 접속 지연을 넘어, Cloudflare를 프록시로 사용하는 전 세계 수백만 개의 웹사이트와 API 서버가 동시에 '''500 Internal Server Error''' 또는 '''502 Bad Gateway'''를 반환하며 먹통이 되었다. 이로 인해 [[Discord]], [[Shopify]], [[OpenAI]](ChatGPT), [[Reddit]] 등 주요 글로벌 IT 서비스가 동시다발적으로 중단되는 초유의 사태가 벌어졌다.

초기에는 트래픽 패턴이 급격히 소멸하는 양상을 보여 대규모 해킹이나 [[DDoS]] 공격으로 의심받았으나, 최종적으로는 내부 설정(Config) 배포 시스템의 결함이 원인으로 밝혀졌다. 인터넷 인프라의 [[단일 실패 지점]](SPOF)이 얼마나 큰 파급력을 가질 수 있는지 보여준 대표적인 사례로 기록되었다.

== 전개 ==
시간은 UTC(협정 세계시)를 기준으로 하며, 괄호 안에 KST(한국 표준시)를 병기한다. 사건의 재구성은 Cloudflare 공식 블로그의 사건 분석 보고서(Incident Report) 및 시스템 상태 페이지(Status Page)의 로그를 기반으로 한다.

=== 장애 발생 및 초기 대응 (11:20 ~ 12:00) ===
* '''11:20 UTC (20:20 KST)''' - '''장애 시작.'''
**: Cloudflare 엔지니어링 팀이 '''봇 관리(Bot Management)''' 제품군의 성능 개선을 위한 정기 업데이트를 배포하기 시작했다. 배포 직후, 북미와 유럽 지역의 주요 데이터센터(PoP)를 시작으로 아시아, 남미 등 전 세계 엣지(Edge) 서버에서 HTTP 요청 처리가 실패하기 시작했다.
**: 엔지니어들이 사용하는 내부 모니터링 대시보드인 Grafana의 트래픽 그래프가 수직 낙하(Nosedive)했다.

* '''11:25 UTC (20:25 KST)''' - '''[오판] DDoS 공격 의심.'''
**: 관제 센터(NOC)에 'Global Traffic Drop' 경보가 울렸다. 트래픽이 빠지는 속도가 물리적 케이블 절단 수준으로 빨랐고, 동시에 5xx 에러율이 100%에 육박했다.
**: 당시 당직 엔지니어들은 이를 "서비스를 마비시키기 위한 전례 없는 규모의 Layer 7 DDoS 공격"으로 판단, 공격 방어 프로토콜을 가동하고 상위 티어 대응 팀을 호출했다.

* '''11:35 UTC (20:35 KST)''' - '''사고 대응 팀(Incident Response Team) 소집.'''
**: 런던, 샌프란시스코, 싱가포르의 시니어 엔지니어들이 긴급 화상 회의(War Room)에 소집되었다. 그러나 보안 팀의 분석 결과, 외부에서 유입되는 악의적인 트래픽 패턴(Attack Signature)이 전혀 발견되지 않았다.
**: 대응 팀은 '''"이것은 공격이 아니라, 내부 시스템의 붕괴(Internal System Failure)"'''라는 결론을 내리고, 최근 변경 사항(ChangeLog)을 역추적하기 시작했다.

=== 원인 파악 및 고립 (12:00 ~ 13:00) ===
* '''12:03 UTC (21:03 KST)''' - '''공식 장애 공지.'''
** Cloudflare Status 페이지에 첫 공지가 게시되었다.
{{인용문|'''Investigating''' - We are currently investigating widespread issues with our services causing 5xx errors and dashboard inaccessibility.<br />조사 중 - 현재 5xx 오류 및 대시보드 접속 불가 현상을 유발하는 광범위한 서비스 문제를 조사하고 있습니다.}}
** 아이러니하게도 Status 페이지 역시 Cloudflare Workers를 일부 사용하고 있어, 로딩 속도가 매우 느리거나 간헐적으로 접속되지 않는 현상이 발생했다.

* '''12:45 UTC (21:45 KST)''' - '''범인 색출.'''
**: 시스템 로그 분석 결과, 전 세계 엣지 서버의 프로세스들이 '''메모리 부족(OOM, Out of Memory)'''으로 인해 강제 종료되고 있음을 확인했다.
**: 프로세스가 재시작(Restart)되자마자 다시 죽어버리는 '''무한 재부팅 루프(Crash Loop)''' 현상이 관측되었다.

=== 복구 및 해결 (13:00 ~ 17:06) ===
* '''13:05 UTC (22:05 KST)''' - '''원인 특정: '봇 관리' 구성 파일.'''
**: 11:20에 배포된 봇 탐지 룰셋(Ruleset) 파일이 평소 크기의 수천 배로 비대해진 것이 확인되었다. 이 거대한 파일이 메모리에 로드되면서 서버를 터뜨린 것.
**: 엔지니어들은 즉시 해당 기능을 비활성화하는 '글로벌 킬 스위치(Global Kill-switch)'를 누르려 했으나, 제어부(Control Plane)조차 과부하로 명령 전달이 지연되었다.

* '''13:10 UTC (22:10 KST)''' - '''1차 우회(Bypass) 조치.'''
**: 중앙 제어가 실패하자, 데이터센터별로 수동 라우팅 변경(BGP 철회 등)을 통해 트래픽을 우회시키거나 문제의 구성 파일을 무시하도록 하는 긴급 패치를 적용하기 시작했다. 일부 지역에서 간헐적으로 접속이 재개됨.

* '''14:24 UTC (23:24 KST)''' - '''롤백(Rollback) 및 배포 차단.'''
**: 문제가 된 데이터베이스 변경 사항을 되돌리고, 정상 작동했던 마지막 버전(Last Known Good Configuration)을 강제로 전체 네트워크에 푸시(Push)했다.

* '''14:30 UTC (23:30 KST)''' - '''트래픽 회복세.'''
**: 롤백 설정이 전파되면서 엣지 서버들의 재부팅 루프가 멈췄다. HTTP 요청 성공률이 0%에서 90%대로 급격히 회복되었다.

* '''17:06 UTC (익일 02:06 KST)''' - '''완전 해결(Resolved).'''
**: 잔여 로그 처리 및 대기열(Queue) 해소가 완료되었다. Cloudflare는 모든 시스템의 정상화를 선언했다.

== 원인 상세 분석 ==
이번 사고는 전형적인 '''"검증 부재가 불러온 나비 효과"'''로 요약된다. 기술적으로는 데이터베이스 쿼리 실수와 배포 파이프라인의 안전장치 미비가 복합적으로 작용했다.

# '''배경 (The Change)'''
#: Cloudflare 엔지니어들은 봇 탐지 정확도를 높이기 위해 봇 신호(Bot Signal)를 처리하는 내부 데이터베이스(ClickHouse 기반)의 스키마를 변경하고 있었다. 이는 통상적인 작업이었다.
# '''실수 (The Bug)'''
#: 변경된 데이터베이스 구조에 맞춰 구성 파일(Config)을 생성하는 SQL 쿼리를 업데이트해야 했으나, 권한 설정 오류로 인해 '''필터링 조건(WHERE 절)이 무시되는 버그'''가 발생했다.
#: 즉, "특정 악성 봇 규칙"만 가져와야 할 쿼리가 데이터베이스에 있는 '''모든 이력 데이터'''를 긁어오게 되었다.
# '''검증 실패 (Validation Gap)'''
#: 생성된 구성 파일(`rules_v2.bin`)의 크기는 평소 약 20KB 수준이었으나, 버그로 인해 '''500MB'''가 넘는 거대 파일이 생성되었다.
#: 문제는 배포 파이프라인(CI/CD)에 "구성 파일 크기가 너무 크면 배포를 중단한다"는 검증 로직이 없었다. 시스템은 이를 정상적인 업데이트로 간주하고 전 세계 수만 대의 서버로 전송했다.
# '''재앙 (The Crash)'''
#: 각 지역의 엣지 서버(Edge Server)에 있는 프록시 데몬(Daemon)이 이 파일을 수신하고 메모리에 로드(Load)를 시도했다.
#: 500MB짜리 구조체를 파싱하여 메모리에 올리는 과정에서 힙(Heap) 메모리가 고갈되었고, 리눅스 커널의 OOM Killer가 해당 프로세스를 강제로 죽여버렸다.
#: 워치독(Watchdog) 프로그램이 죽은 프로세스를 다시 살려냈지만, 살아나자마자 다시 거대 파일을 읽고 죽는 과정이 초당 수십 번 반복되었다.

== 피해 규모 ==
Cloudflare는 전 세계 웹 트래픽의 약 20%를 처리하는 거대한 허브이기 때문에, 그 피해는 광범위했다.

* '''주요 서비스 중단''':
** [[Discord]]: 메시지 전송 실패 및 API 오류로 서비스가 완전히 중단됨. 앱 실행 시 로딩 화면에서 멈추는 현상 발생.
** [[OpenAI]]: ChatGPT 웹 인터페이스 및 API가 모두 응답 없음(Timeout) 상태가 됨. 이를 기반으로 하는 수많은 AI 스타트업 서비스들이 연쇄적으로 마비됨.
** [[Shopify]]: 수백만 개의 쇼핑몰 결제 페이지가 열리지 않아 매출에 직접적인 타격을 입음.
** [[X (SNS)|X (구 트위터)]]: 이미지 및 미디어 서버가 Cloudflare를 경유하는 경우 로딩되지 않음.

* '''암호화폐 거래소''': [[바이낸스]], [[코인베이스]] 등 주요 거래소의 API 접속이 차단되어 트레이딩 봇들이 오작동하거나 매매가 불가능해지는 혼란이 빚어짐.
* '''개발자 생태계''': [[npm]], [[PyPI]] 등의 패키지 저장소 미러링 사이트들이 접속되지 않아 전 세계 개발자들의 업무(빌드 및 배포)가 중단됨.

== 사후 조치 및 반응 ==
=== Cloudflare의 대응 ===
사건 발생 3일 후, Cloudflare는 매우 상세한 기술적 사후 분석(Post-mortem)을 블로그에 공개했다. CEO 매튜 프린스(Matthew Prince)는 트위터를 통해 "변명의 여지가 없다. 우리의 테스트 절차에 구멍이 있었다"며 사과했다.

Cloudflare는 다음과 같은 재발 방지 대책을 발표했다.
* '''최대 파일 크기 제한(Hard Limit) 도입''': 구성 파일이 일정 크기를 초과하면 배포 파이프라인 단계에서 즉시 실패(Fail) 처리하도록 수정.
* '''카나리아 배포(Canary Release) 강화''': 모든 설정 변경 사항은 내부 테스트베드 → 소규모 PoP → 지역 → 전 세계 순으로 시차를 두고 배포되도록 강제화. (이전에도 있었으나 긴급 패치 경로에서 일부 생략되었던 것을 수정)
* '''장애 복구 모드(Panic Mode) 개선''': 중앙 제어 시스템이 마비되더라도 엣지 서버가 자동으로 "마지막으로 성공한 설정(Last Known Good)"으로 롤백하는 로직 추가.

=== 여담 및 반응 ===
* '''"또 너냐?"''': 2020년, 2022년에 이어 2025년에도 유사한 '설정 오류'로 인한 대형 사고가 터지자 IT 커뮤니티에서는 "인터넷의 왕(Cloudflare)이 재채기를 하면 전 세계가 감기에 걸린다"는 농담 아닌 농담이 돌았다.
* [[Hacker News]]와 [[Reddit]]의 r/sysadmin 게시판은 아수라장이 되었다. 특히 "회사 서버가 다운됐는데 내가 고칠 수 있는 게 없어서(Cloudflare 문제라서) 오히려 마음 편하게 퇴근했다"는 반응과 "고객사 전화 받느라 지옥을 맛봤다"는 반응이 공존했다.
* 장애 시간 동안 인터넷 트래픽이 급감하자, 일부 인터넷 서비스 제공자(ISP)들은 대역폭 여유분이 넘쳐나는 기현상이 발생하기도 했다.
* 이 사건의 여파로 경쟁사인 [[AWS]] CloudFront나 [[Fastly]]의 주가가 일시적으로 상승하는 모습을 보였다.

== 관련 문서 ==
* [[Cloudflare]]
* [[CDN]]
* [[단일 실패 지점]] (SPOF)
* [[2022년 6월 Cloudflare 장애]] - 유사한 원인(라우팅 설정 오류)으로 발생했던 사건.
* [[사건 사고 관련 정보]]
* [[인프라 엔지니어링]]

[[분류:2025년 사건 사고]]
[[분류:인터넷 검열 및 차단]]
[[분류:Cloudflare]]
[[분류:소프트웨어 버그]]

틀:기업정보

2025-11-20T23:18:36Z

Admin: 시작

<noinclude>
이 문서는 기업 정보를 요약해서 보여주는 틀입니다.
문서의 최상단에 아래 내용을 복사하여 사용하세요.

<pre>
{{틀:기업정보
|기업명 =
|로고 =
|국가 =
|설립일 =
|업종 =
|본사 =
|창업자 =
|CEO =
|상장유무 =
|웹사이트 =
}}
</pre>
</noinclude><includeonly>{| style="float: right; width: 300px; margin: 0 0 1em 1em; border: 1px solid #a2a9b1; border-radius: 5px; background-color: #fff; font-size: 90%; border-spacing: 0; padding: 0;"
|-
! colspan="2" style="background-color: #3777bc; color: #ffffff; text-align: center; font-size: 110%; padding: 8px; border-top-left-radius: 5px; border-top-right-radius: 5px;" | '''{{{기업명|{{PAGENAME}}}}}'''
|-
| colspan="2" style="text-align: center; padding: 15px 0; border-bottom: 1px solid #a2a9b1;" | {{{로고|}}}
|-
{{#if:{{{국가|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom: 1px solid #e0e0e0;" {{!}} 국가
{{!}} style="padding: 4px 8px; border-bottom: 1px solid #e0e0e0;" {{!}} {{{국가}}}
{{!}}-
}}
{{#if:{{{설립일|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom: 1px solid #e0e0e0;" {{!}} 설립일
{{!}} style="padding: 4px 8px; border-bottom: 1px solid #e0e0e0;" {{!}} {{{설립일}}}
{{!}}-
}}
{{#if:{{{업종|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom: 1px solid #e0e0e0;" {{!}} 업종
{{!}} style="padding: 4px 8px; border-bottom: 1px solid #e0e0e0;" {{!}} {{{업종}}}
{{!}}-
}}
{{#if:{{{창업자|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom: 1px solid #e0e0e0;" {{!}} 창업자
{{!}} style="padding: 4px 8px; border-bottom: 1px solid #e0e0e0;" {{!}} {{{창업자}}}
{{!}}-
}}
{{#if:{{{CEO|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom: 1px solid #e0e0e0;" {{!}} 주요 인물
{{!}} style="padding: 4px 8px; border-bottom: 1px solid #e0e0e0;" {{!}} {{{CEO}}}
{{!}}-
}}
{{#if:{{{본사|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom: 1px solid #e0e0e0;" {{!}} 본사 소재지
{{!}} style="padding: 4px 8px; border-bottom: 1px solid #e0e0e0;" {{!}} {{{본사}}}
{{!}}-
}}
{{#if:{{{상장유무|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom: 1px solid #e0e0e0;" {{!}} 기업 형태
{{!}} style="padding: 4px 8px; border-bottom: 1px solid #e0e0e0;" {{!}} {{{상장유무}}}
{{!}}-
}}
{{#if:{{{웹사이트|}}}|
! style="background-color: #f2f2f2; text-align: left; padding: 4px 8px; width: 30%; border-bottom-left-radius: 5px;" {{!}} 웹사이트
{{!}} style="padding: 4px 8px; border-bottom-right-radius: 5px;" {{!}} {{{웹사이트}}}
}}
|}</includeonly>

Cloudflare

2025-11-20T23:17:30Z

Admin: 최신화

{{기업 정보
|기업명 = Cloudflare, Inc.<br />클라우드플레어
|로고 = [[파일:Cloudflare_Logo.png|200px]]
|국가 = [[미국]]
|설립일 = 2009년 7월
|창업자 = 매튜 프린스(Matthew Prince)<br />리 할로웨이(Lee Holloway)<br />미셸 자틀린(Michelle Zatlyn)
|CEO = 매튜 프린스 (2009~)
|본사 = 미국 캘리포니아 샌프란시스코
|상장유무 = 상장 (NYSE: [[NET]])
|업종 = [[CDN]], 보안, 엣지 컴퓨팅, DNS
|웹사이트 = [https://www.cloudflare.com/ko-kr/ 공식 홈페이지]
}}

{{틀:인용문|'''Helping Build a Better Internet'''<br />더 나은 인터넷 환경을 구축하도록 돕는다.}}

== 개요 ==
미국의 웹 인프라 및 보안 회사. 전 세계적으로 가장 널리 사용되는 [[CDN]](Content Delivery Network) 및 [[DDoS]] 방어 서비스 제공 업체 중 하나이다.

단순히 콘텐츠 전송 속도를 높이는 것을 넘어, 웹사이트 앞단에서 트래픽을 먼저 받아 처리하는 [[리버스 프록시]] 역할을 수행한다. 이 때문에 클라우드플레어를 사용하는 사이트의 실제 서버 IP는 숨겨지며, 외부 공격으로부터 원본 서버를 보호하는 거대한 방패 역할을 한다.

압도적인 무료 플랜의 가성비와 막강한 네트워크 대역폭으로 인해 개인 블로그부터 대기업, 심지어 국가 기관까지 폭넓게 사용하고 있다.

== 역사 ==
2004년, 창업자 매튜 프린스와 리 할로웨이는 이메일 스팸의 원천을 추적하는 '프로젝트 허니팟(Project Honey Pot)'을 시작했다. 이 프로젝트를 통해 수집된 데이터를 바탕으로, 웹 공격을 사전에 차단하고 성능을 개선하는 서비스를 구상하게 된 것이 클라우드플레어의 시초다. 2009년 정식으로 회사를 설립했고, 테크크런치 디스럽트(TechCrunch Disrupt) 등에서 주목받으며 급성장했다.

2019년 9월, 뉴욕증권거래소(NYSE)에 티커명 '''NET'''으로 상장했다.

== 주요 서비스 ==
=== CDN 및 캐싱 ===
클라우드플레어의 핵심 서비스. 전 세계 120개국 330개 이상의 도시(2024년 기준)에 엣지 서버(Edge Server)를 두고 있다. 사용자가 사이트에 접속하면 원본 서버 대신 가장 가까운 클라우드플레어 엣지 서버가 저장해 둔(캐싱된) 콘텐츠를 보내준다.

* '''Anycast Network''': 클라우드플레어의 모든 서버는 동일한 IP 주소를 가진다. BGP(Border Gateway Protocol)의 애니캐스트 기술을 이용해 사용자를 물리적으로 가장 가까운 서버로 자동 연결한다.

=== DDoS 방어 ===
사실상 클라우드플레어를 쓰는 가장 큰 이유 중 하나.
무료 플랜에서도 '''무제한(Unmetered)''' DDoS 방어를 제공한다. 어지간한 규모의 공격은 클라우드플레어 네트워크 선에서 정리되며, 원본 서버에는 트래픽이 도달조차 하지 않는다.
* '''Under Attack Mode''': 사이트가 공격받고 있을 때 이 모드를 켜면, 접속자에게 "잠시만 기다려주세요"라는 문구와 함께 JS 챌린지(브라우저 검증)를 거치게 한다. 봇(Bot)을 걸러내는 데 매우 효과적이다.

=== DNS (1.1.1.1) ===
2018년 만우절(4월 1일)에 출시한 퍼블릭 DNS 서비스. IP 주소는 [[1.1.1.1]]이다.
* '''속도''': 구글의 8.8.8.8보다 반응 속도가 빠르다고 홍보하며, 실제로도 벤치마크 상 최상위권이다.
* '''개인정보''': 사용자 로그를 24시간 내에 삭제하고, 데이터를 판매하지 않는다고 강조한다.

=== Serverless (Workers & Pages) ===
* '''Cloudflare Workers''': 서버 없이 코드를 실행할 수 있는 엣지 컴퓨팅 플랫폼. AWS Lambda와 비슷하지만, 콜드 스타트(Cold Start)가 거의 없고 전 세계 엣지에서 동시에 실행된다는 점이 강점이다. 초기에는 JavaScript(V8 엔진)만 지원했으나 현재는 Rust, C++ 등 Wasm을 지원하는 언어도 사용 가능하다.
* '''Cloudflare Pages''': 정적 사이트 호스팅 서비스. [[GitHub]] 등과 연동하여 배포할 수 있다. [[Netlify]]나 [[Vercel]]의 경쟁 서비스. 무료 티어의 대역폭 제한이 없어 인기가 많다.

=== Zero Trust & Security ===
* '''Cloudflare Access''': VPN 없이 내부 인프라에 안전하게 접속하게 해주는 서비스.
* '''WARP''': 일반 사용자용 VPN 서비스. 1.1.1.1 앱에 통합되어 있다. IP를 숨겨주지만, 일반적인 VPN처럼 국가 변경을 통한 우회 목적보다는 보안과 속도 최적화(트래픽 압축 등)에 초점이 맞춰져 있다.
* '''Turnstile''': 구글의 reCAPTCHA를 대체하기 위해 만든 솔루션. "신호등을 찾으세요" 같은 귀찮은 그림 맞추기 없이, 사용자의 브라우저 환경을 분석해 사람인지 봇인지 판별한다.

== 요금제 및 기능 제한 ==
기본적으로 '''Free(무료), Pro(프로), Business(비즈니스), Enterprise(엔터프라이즈)''' 4단계로 나뉜다.

* '''Free''': 개인 웹사이트나 취미용. 기본적은 CDN, DDoS 방어, 공유 SSL 인증서를 제공한다. 이것만으로도 웬만한 중소형 호스팅 업체의 유료 옵션보다 낫다.
* '''Pro''': 월 $20(예상). 이미지 최적화(Polish), 모바일 최적화(Mirage), 웹 방화벽(WAF) 규칙이 추가된다.
* '''Business''': 월 $200. 100% 가동 시간 보장(SLA), 커스텀 SSL 인증서 업로드, 고급 WAF 등을 지원한다.
* '''Enterprise''': 별도 견적. 전담 기술 지원, 중국 본토(China Network) 접속 지원, 그리고 '''국내(ICN) 경로 보장''' 등이 포함된다.

== 대한민국에서의 망 연동 문제 (ICN) ==
한국 사용자들에게 클라우드플레어는 애증의 존재다. '''"속도는 빠른데 느리다"'''라는 모순적인 상황이 발생하기 때문이다.

=== 문제의 원인 ===
핵심은 [[대한민국]]의 살인적인 '''망 사용료(Transit Fee)''' 때문이다.
클라우드플레어는 전 세계 대부분의 IX(인터넷 교환 지점)와 무료로 피어링(Peering)을 맺거나 저렴하게 연결하지만, 한국의 통신 3사(KT, SKB, LGU+)는 상호 접속료 정산 방식(발신자 종량제 등)과 높은 망 비용 정책을 고수하고 있다.

이 때문에 클라우드플레어 입장에서 한국 내에 서버(ICN)를 두고 트래픽을 처리하는 것은 비용 부담이 매우 크다.

=== 티어별 라우팅 차별 ===
이에 따라 클라우드플레어는 비용 절감을 위해 요금제별로 트래픽 경로를 다르게 설정한다.

* '''Free / Pro 플랜''': <del>한국에 서버가 있는데 왜 쓰질 못하니</del>
*: 과거에는 무료 플랜도 간혹 인천(ICN) 노드로 연결되었으나, 현재는 거의 대부분 '''일본 도쿄(NRT), 오사카(KIX)''' 또는 '''미국 로스앤젤레스(LAX), 산호세(SJC)''' 등으로 우회된다.
*: 한국에서 접속하는데 일본이나 미국을 찍고 오니 핑(Ping)이 튀고 반응 속도가 느려질 수밖에 없다. 다만 대역폭 자체는 넓어서 파일 다운로드 속도는 나쁘지 않은 편.
*: 운이 좋으면 국내 ISP에 따라 간혹 ICN으로 잡히기도 하지만, 언제 다시 튕겨나갈지 모른다.

* '''Business 플랜''':
*: 공식적으로는 우선순위가 높지만, 한국에서는 비즈니스 플랜조차 ICN 접속을 100% 보장하지 않는 경우가 많다. <del>200달러 냈는데 일본 가면 억장 무너진다.</del>

* '''Enterprise 플랜''':
*: 돈의 힘으로 해결하는 단계. 엔터프라이즈 계약 시 '''ICN 리전 고정'''을 옵션으로 넣을 수 있다. 이 경우 한국 통신사와 직접 연동된 대역폭을 사용하여 국내 호스팅급의 미친 속도(지연시간 1~5ms)를 보여준다. 나무위키도 한때 이 플랜을 사용했었다.<ref>현재 나무위키는 자체적인 인프라 구성 및 다른 CDN을 혼용하는 것으로 알려져 있다.</ref>

=== 주의사항: 트래픽 요금 폭탄 ===
CDN이 해외(일본, 미국)로 잡히는 경우, 원본 서버가 한국에 있다면 주의해야 한다.
# 사용자가 사이트 접속 (한국 → 일본/미국 Cloudflare)
# Cloudflare가 원본 서버에 데이터 요청 (일본/미국 → 한국 원본 서버)
# 원본 서버가 데이터 전송 (한국 → 일본/미국)

이 과정에서 한국 호스팅 업체(AWS 서울 리전, 카페24 등) 입장에서 보면 '''해외로 나가는 트래픽(Outbound Traffic)'''이 발생한다. 국내 호스팅이나 클라우드 서비스는 해외 트래픽 비용이 국내보다 비싼 경우가 많으므로, 자칫하면 배보다 배꼽이 더 커지는 '''요금 폭탄'''을 맞을 수 있다.

== 사건 사고 ==
=== 클라우드블러드 (Cloudbleed) ===
2017년 2월에 발견된 심각한 보안 취약점. 하트블리드(Heartbleed) 사태에 빗대어 명명되었다.
클라우드플레어의 HTML 파서 코드(Ragel로 작성됨)에 버그가 있어, 버퍼 오버플로우가 발생했고 이로 인해 메모리에 있던 '''다른 웹사이트의 민감한 정보(쿠키, 세션, 비밀번호, 인증 토큰 등)'''가 유출되어 검색 엔진 캐시에 저장된 사건이다.
* 클라우드플레어 측은 신속하게 패치하고 구글 등 검색 엔진과 협력하여 캐시를 삭제했지만, 보안 회사의 신뢰도에 큰 타격을 입었다.

=== 2019년, 2022년 대규모 장애 ===
* '''2019년 7월''': 전 세계적으로 클라우드플레어를 사용하는 사이트들이 502 Bad Gateway를 띄우며 접속 불가 상태가 되었다. 원인은 WAF(웹 방화벽) 규칙 배포 중 잘못 작성된 [[정규 표현식]] 하나가 CPU를 100% 점유하게 만들었기 때문. <del>정규식의 무서움</del>
* '''2022년 6월''': 19개 데이터 센터에서 트래픽이 마비되는 사고가 발생했다. 네트워크 구성 변경 중 오류가 원인이었다.

=== 키위팜(Kiwi Farms) 차단 논란 ===
표현의 자유 절대주의를 표방하며 어지간한 사이트(네오나치 사이트 데일리 스톰포 등)도 차단하지 않던 클라우드플레어가, 2022년 온라인 스토킹과 괴롭힘으로 악명 높은 커뮤니티 '키위팜'의 서비스를 종료시켰다.
매튜 프린스 CEO는 "이 결정은 위험한 선례가 될 수 있어 불편하다"면서도, 현실적인 인명 피해 위협이 임박했기에 차단했다고 밝혔다. 이는 인프라 기업이 콘텐츠 검열 권한을 어디까지 가질 수 있는가에 대한 논쟁을 불러일으켰다.

=== 2025년 11월 글로벌 네트워크 장애 ===
[[2025년 11월 Cloudflare Global Network 장애]] 문서를 확인해주시기 바랍니다.

== 기술적 특징 ==
* '''Nginx에서 Pingora로''': 오랫동안 [[Nginx]]를 개조하여 사용했으나, 아키텍처의 한계와 메모리 안전성 문제 등을 이유로 [[Rust]] 언어로 자체 개발한 프록시 엔진인 '''Pingora'''로 교체했다. 이로 인해 CPU 사용량을 대폭 줄이고 트래픽 처리 효율을 높였다고 한다.
* '''Lava Lamps''': 샌프란시스코 본사 로비에는 수많은 [[라바 램프]]가 진열되어 있다. 이 램프들이 무작위로 움직이는 패턴을 카메라로 촬영하여 암호화에 필요한 '''난수(Random Number)'''를 생성하는 데 사용한다. <del>물리적 난수 생성기</del>

== 여담 ==
* 인터넷의 약 20% 이상의 트래픽이 클라우드플레어를 거쳐간다고 한다. 만약 클라우드플레어가 멈추면 인터넷의 1/5이 마비되는 셈.
* [[나무위키]]의 경우, 과거 잦은 DDoS 공격으로 인해 접속이 불안정할 때마다 "클라우드플레어 에러 화면"이 떠서 유저들에게 매우 친숙(?)하다.
* 403 Forbidden 오류 페이지 등의 디자인을 사용자가 커스터마이징 할 수 없게 되어 있다(Enterprise 제외). 그래서 클라우드플레어 특유의 에러 화면만 봐도 "아, 여기도 클플 쓰는구나"라고 바로 알 수 있다.

== 각주 ==
<references />

가온 위키:대문

2025-11-20T23:10:48Z

Admin: 클라우드플레어 오류 끝남

<div style="border-top: 8px solid #00BCD4; padding: 25px; box-shadow: 0 4px 12px rgba(0,0,0,0.1); text-align: center; border-radius: 12px; background: linear-gradient(135deg, #f8f9fa 0%, #ffffff 100%); margin-bottom: 20px;">
<div style="margin-bottom: 15px;">
<big style="font-size: 28px; font-weight: bold; color: #2c3e50;">모두의 <s style="color: #e74c3c;">마블</s>, 가온 위키!</big>
</div>

<p style="font-size: 20px; color: #34495e; margin: 10px 0;">[[가온 위키]]에 오신 것을<br><strong>환영합니다!</strong></p>

<div style="margin-top: 20px; padding: 15px; background-color: rgba(0, 188, 212, 0.1); border-radius: 8px;">
<big style="color: #00695c;">[[가온 위키]]는 누구든 참여할 수 있는 열린 위키입니다!</big>
</div>
</div>

<hr style="border: none; height: 3px; background: linear-gradient(to right, #00BCD4, #4CAF50); margin: 30px 0;" />

<div style="border: 2px solid #e1e8ed; border-radius: 12px; padding: 30px; background-color: #fafbfc; box-shadow: 0 2px 8px rgba(0,0,0,0.05);">
{| class="mw-collapsible" style="width: 100%; background: transparent;"
|+ style="font-size: 24px; font-weight: bold; color: #2c3e50; padding: 15px 0;" | 📢 공지사항
|-
| style="padding: 20px;" |
<div style="background: #fff; padding: 20px; border-radius: 8px; margin-bottom: 15px; border-left: 4px solid #4CAF50;">
'''📖 사용법 안내'''<br>
위키 편집이 처음이신가요? [[도움말:위키 문법|위키 문법]]을 같이 배워봐요. 고급 사용자 이신가요? 새로운 문법, [[2023 문법 개선 프로젝트|📚 위키 사용법 가이드]]를 확인해보세요!
</div>

<div style="text-align: center; margin-top: 25px; padding: 15px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 8px;">
<span style="color: white; font-weight: bold;">💬 더 많은 정보가 필요하신가요?</span><br>
<span style="color: #f0f0f0;">[https://bbs.gaonwiki.com/notice 공지사항 게시판]에서 최신 소식을 확인하세요!</span>
</div>
|}
</div>

<div style="margin-top: 30px; text-align: center; padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 12px; color: white;">
<h3 style="margin: 0 0 15px 0;">🚀 위키 참여하기</h3>
<p style="margin: 0; opacity: 0.9;">지식을 공유하고, 함께 만들어가는 가온 위키의 일원이 되어보세요!</p>
</div>

미디어위키:Minerva.css

2025-11-19T11:12:57Z

Admin: 디자인 개선

/* All CSS here will be loaded for users of the MinervaNeue skin */
/* 가온 위키 Minerva 커스텀 메뉴 스타일 */

/* 레벨 2, 3 <ul> 기본값 정리 */
.gaon-menu-level2,
.gaon-menu-level3 {
margin: 0;
padding: 0;
list-style: none;
}

/* 상위 그룹(게시판 / 버그/기능 개선 / 도구 / 도움말) 라인 */
.gaon-menu-header > .gaon-menu-header__anchor {
font-weight: 600;
/* Minerva 기본 anchor(.toggle-list-item__anchor)와 동일한 레이아웃 유지 */
display: flex;
align-items: center;
}

/* 하위 항목 anchor 의 레이아웃 정리 */
.gaon-menu-item > .gaon-menu-link {
display: flex;
align-items: center;
}

/* 아이콘과 텍스트 사이 간격 */
.gaon-menu .minerva-icon + .toggle-list-item__label {
margin-left: 0.6em;
}

/* 레벨별 들여쓰기
- Minerva 기본 padding 에 더해 추가 padding 을 주는 방식 */
.gaon-menu-item-level2 > .gaon-menu-link {
padding-left: 2.5em; /* 2단계는 살짝 들여쓰기 */
}

.gaon-menu-item-level3 > .gaon-menu-link {
padding-left: 3.5em; /* 3단계는 조금 더 들여쓰기 */
}

/* 펼침/접힘 화살표(상위 그룹 오른쪽) */
.gaon-menu-header > .gaon-menu-header__anchor::after {
content: '▾';
margin-left: auto;
font-size: 0.7em;
opacity: 0.7;
}

/* 접힌 상태의 상위 그룹 화살표 */
.gaon-menu-header--collapsed > .gaon-menu-header__anchor::after {
content: '▸';
}

/* 2단계 중 children 이 있는 항목(예: 파일 올리기)의 화살표 */
.gaon-menu-item--has-children > .gaon-menu-link::after {
content: '▾';
margin-left: auto;
font-size: 0.7em;
opacity: 0.7;
}

/* 접힌 상태의 2단계 화살표 */
.gaon-menu-item--collapsed > .gaon-menu-link::after {
content: '▸';
}

미디어위키:Minerva.js

2025-11-19T11:12:40Z

Admin: 구조 개선

/* All JavaScript here will be loaded for users of the MinervaNeue skin */
/* 가온 위키 Minerva Neue 전용 커스텀 메뉴
* - PC/모바일 공통
* - Minerva 기본 메뉴와 같은 구조/클래스 사용
* (toggle-list__list / toggle-list-item / toggle-list-item__anchor /
* minerva-icon / toggle-list-item__label)
* - 상위 그룹(게시판, 버그/기능 개선, 도구, 도움말)은 접고 펼칠 수 있음
* - "파일 올리기" 아래에 3단계 메뉴 포함
*/

( function ( mw, $ ) {
'use strict';

// Minerva 스킨이 아닐 때는 아무 것도 하지 않는다.
if ( mw.config.get( 'skin' ) !== 'minerva' ) {
return;
}

/* -------------------------------------------------
* 1. 메뉴 설정 (질문에서 주신 내용을 JS 객체로 변환)
* ------------------------------------------------- */

// icon 필드에는 Minerva 메뉴에서 사용하는
// `minerva-icon minerva-icon--XXX` 의 XXX 부분만 넣는다.
// 예: icon: 'minerva-icon--speechBubbles'
var gaonMenuConfig = [
{
// 게시판 그룹
label: '게시판',
icon: 'minerva-icon--speechBubbles',
children: [
{
label: '위키방',
href: 'https://bbs.gaonwiki.com',
title: 'https://bbs.gaonwiki.com',
icon: 'minerva-icon--speechBubbles'
},
{
label: '저작권 처리 게시판',
href: 'https://bbs.gaonwiki.com/copyrights',
title: 'https://bbs.gaonwiki.com/copyrights',
icon: 'minerva-icon--speechBubbles'
},
{
label: '자유게시판',
href: 'https://bbs.gaonwiki.com/free',
title: 'https://bbs.gaonwiki.com/free',
icon: 'minerva-icon--speechBubbles'
}
]
},
{
// 버그/기능 개선 그룹
label: '버그/기능 개선',
icon: 'minerva-icon--die',
children: [
{
label: '이슈 등록',
href: 'https://bbs.gaonwiki.com/issue',
title: 'https://bbs.gaonwiki.com/issue',
icon: 'minerva-icon--die'
},
{
label: '기능 구현 도움',
href: 'https://www.gaonwiki.com/w/%EA%B0%80%EC%98%A8_%EC%9C%84%ED%82%A4:%EA%B8%B0%EB%8A%A5_%EA%B5%AC%ED%98%84_%EB%B6%88%EA%B0%80-%EB%88%84%EA%B0%80_%ED%95%B4%EA%B2%B0%EC%B1%85%EC%9D%84_%EC%95%8C%EB%A0%A4%EC%A3%BC%EC%84%B8%EC%9A%94!',
title: 'https://www.gaonwiki.com/w/가온_위키:기능_구현_불가-누가_해결책을_알려주세요!',
icon: 'minerva-icon--speechBubbles'
},
{
label: '알려진 문제들',
href: 'https://www.gaonwiki.com/w/%EA%B0%80%EC%98%A8_%EC%9C%84%ED%82%A4/%EC%95%8C%EB%A0%A4%EC%A7%84_%EB%AC%B8%EC%A0%9C%EB%93%A4',
title: 'https://www.gaonwiki.com/w/가온_위키/알려진_문제들',
icon: 'minerva-icon--recentChanges'
}
]
},
{
// 도구 그룹
label: '도구',
icon: 'minerva-icon--specialPages',
children: [
{
label: '특수 문서 목록',
href: mw.util.getUrl( '특수:특수문서' ),
title: '특수:특수문서',
icon: 'minerva-icon--specialPages'
},
{
// "파일 올리기" (3단계 메뉴를 가진 항목)
label: '파일 올리기',
href: '#', // 드롭다운 전용이므로 실제 링크는 없음
title: '파일 올리기',
icon: 'minerva-icon--specialPages',
children: [
{
label: '(기존) 업로드',
href: mw.util.getUrl( '특수:올리기' ),
title: '특수:올리기',
icon: 'minerva-icon--specialPages'
},
{
label: '(신규) 업로드 마법사',
href: mw.util.getUrl( '특수:UploadWizard' ),
title: '특수:UploadWizard',
icon: 'minerva-icon--specialPages'
}
]
},
{
label: '이슈 트래커',
href: 'https://bbs.gaonwiki.com/issue/',
title: 'https://bbs.gaonwiki.com/issue/',
icon: 'minerva-icon--die'
},
{
label: '가온 위키 베타',
href: 'https://beta.gaonwiki.com',
title: 'https://beta.gaonwiki.com',
icon: 'minerva-icon--specialPages'
}
]
},
{
// 도움말 그룹
label: '도움말',
icon: 'minerva-icon--specialPages',
children: [
{
label: '위키 문법',
href: mw.util.getUrl( '도움말:위키_문법' ),
title: '도움말:위키_문법',
icon: 'minerva-icon--specialPages'
},
{
label: '설명서',
href: mw.util.getUrl( '도움말:설명서' ),
title: '도움말:설명서',
icon: 'minerva-icon--specialPages'
}
]
}
];

/* -------------------------------------------------
* 2. DOM 생성 유틸리티
* ------------------------------------------------- */

/**
* Minerva 스타일의 아이콘 <span> 요소를 생성한다.
*
* @param {string} iconClass "minerva-icon--XXX" 형식의 클래스
* @return {jQuery}
*/
function buildIcon( iconClass ) {
var $icon = $( '<span>' ).addClass( 'minerva-icon' );
if ( iconClass ) {
$icon.addClass( iconClass );
}
return $icon;
}

/**
* 메뉴 라벨 <span> 요소를 생성한다.
*
* @param {string} text 화면에 보일 텍스트
* @return {jQuery}
*/
function buildLabel( text ) {
return $( '<span>' )
.addClass( 'toggle-list-item__label' )
.text( text || '' );
}

/**
* Minerva 스타일의 <a> 요소를 생성한다.
*
* @param {string} href 링크 URL (없으면 '#')
* @param {string} title title 속성
* @return {jQuery}
*/
function buildAnchor( href, title ) {
return $( '<a>' )
.addClass( 'toggle-list-item__anchor gaon-menu-link' )
.attr( 'href', href || '#' )
.attr( 'title', title || '' );
}

/**
* 하위 메뉴 항목(레벨 2, 3)을 재귀적으로 생성하여 <ul> 안에 추가한다.
*
* @param {jQuery} $ul 현재 레벨의 <ul>
* @param {Object} item 메뉴 정의 객체
* @param {number} level 레벨 번호(2, 3, ...)
*/
function appendGaonMenuItem( $ul, item, level ) {
var hasChildren = Array.isArray( item.children ) && item.children.length > 0;

// <li> 생성
var $li = $( '<li>' )
.addClass( 'toggle-list-item gaon-menu-item gaon-menu-item-level' + level );

if ( hasChildren ) {
$li.addClass( 'gaon-menu-item--has-children gaon-menu-item--collapsed' );
}

// <a> 생성
var $a = buildAnchor( item.href, item.title || item.label );
$a.append( buildIcon( item.icon ) );
$a.append( buildLabel( item.label ) );
$li.append( $a );
$ul.append( $li );

// 하위 레벨이 있으면 <ul> 을 만들어 재귀 호출
if ( hasChildren ) {
var nextLevel = level + 1;
var $subUl = $( '<ul>' )
.addClass( 'gaon-menu gaon-menu-level' + nextLevel );

item.children.forEach( function ( child ) {
appendGaonMenuItem( $subUl, child, nextLevel );
} );

// 이 부분이 중요:
// 하위 <ul> 은 반드시 <li> 안에 들어가야 한다.
$li.append( $subUl );
}
}

/**
* 한 개의 상위 그룹(게시판 / 버그/기능 개선 / 도구 / 도움말)을
* Minerva 스타일의 <ul> 블록으로 생성한다.
*
* @param {Object} group 그룹 정의
* @param {number} index 그룹 index
* @return {jQuery} 완성된 <ul> 요소
*/
function buildGroup( group, index ) {
// Minerva 기본 메뉴와 같은 class 사용
var $level1 = $( '<ul>' )
.addClass( 'toggle-list__list gaon-menu gaon-menu-level1' )
.attr( 'data-gaon-group-index', index );

var hasChildren = Array.isArray( group.children ) && group.children.length > 0;

// 헤더 <li>
var $headerLi = $( '<li>' )
.addClass( 'toggle-list-item gaon-menu-header gaon-menu-header--collapsed' );

var $headerA = buildAnchor( '#', group.label );
$headerA
.addClass( 'gaon-menu-header__anchor' )
.append( buildIcon( group.icon ) )
.append( buildLabel( group.label ) );

$headerLi.append( $headerA );

// 그룹에 하위 항목이 있으면 level2 <ul> 생성
if ( hasChildren ) {
var $level2 = $( '<ul>' )
.addClass( 'gaon-menu gaon-menu-level2' );

group.children.forEach( function ( item ) {
appendGaonMenuItem( $level2, item, 2 );
} );

// 헤더 <li> 안에 하위 <ul> 을 넣는다.
$headerLi.append( $level2 );
}

$level1.append( $headerLi );
return $level1;
}

/* -------------------------------------------------
* 3. 메뉴를 실제 Minerva 햄버거 메뉴 안에 삽입
* ------------------------------------------------- */

/**
* 가온 메뉴를 Minerva 왼쪽 메뉴에 삽입한다.
*/
function insertGaonMenuIntoMinerva() {
// 기본 내비게이션 블록(대문/임의의 문서로)이 들어 있는 첫 번째 toggle-list__list 를 찾는다.
var $firstList = $( '#p-navigation.toggle-list__list' ).first();

// 혹시 id 가 다르다면 fallback: 메뉴 안의 첫 toggle-list__list
if ( !$firstList.length ) {
$firstList = $( '#mw-mf-page-left .toggle-list__list' ).first();
}

if ( !$firstList.length ) {
return;
}

// 중복 삽입 방지
if ( $firstList.data( 'gaonMenuInjected' ) ) {
return;
}
$firstList.data( 'gaonMenuInjected', true );

// 여러 그룹을 한 번에 생성하여 첫 번째 리스트 뒤에 삽입
var $allGroups = $( [] );
gaonMenuConfig.forEach( function ( group, index ) {
$allGroups = $allGroups.add( buildGroup( group, index ) );
} );

$firstList.after( $allGroups );

// 모든 하위 레벨을 기본적으로 숨긴다.
$( '.gaon-menu-level2, .gaon-menu-level3' ).hide();

// 상위 그룹 헤더 클릭 시 level2 토글
$( '.gaon-menu-header__anchor' ).on( 'click', function ( e ) {
e.preventDefault();

var $headerLi = $( this ).closest( '.gaon-menu-header' );
var $sub = $headerLi.children( '.gaon-menu-level2' );

if ( !$sub.length ) {
return;
}

$headerLi.toggleClass( 'gaon-menu-header--collapsed' );
$sub.slideToggle( 150 );
} );

// "파일 올리기"처럼 children 이 있는 2단계 항목 클릭 시 level3 토글
$( '.gaon-menu-item--has-children > .gaon-menu-link' ).on( 'click', function ( e ) {
e.preventDefault();

var $li = $( this ).closest( '.gaon-menu-item--has-children' );
var $sub = $li.children( '.gaon-menu-level3' );

if ( !$sub.length ) {
return;
}

$li.toggleClass( 'gaon-menu-item--collapsed' );
$sub.slideToggle( 150 );
} );
}

/* -------------------------------------------------
* 4. 메뉴 HTML 로드 완료를 기다렸다가 삽입
* ------------------------------------------------- */

var maxAttempts = 50; // 최대 50번(약 5초 정도) 시도
var attemptCount = 0;

function waitForMinervaMenu() {
var $firstList = $( '#mw-mf-page-left .toggle-list__list' ).first();

if ( $firstList.length ) {
insertGaonMenuIntoMinerva();
} else if ( attemptCount < maxAttempts ) {
attemptCount += 1;
setTimeout( waitForMinervaMenu, 100 );
}
}

$( waitForMinervaMenu );

}( mediaWiki, jQuery ) );

미디어위키:Minerva.css

2025-11-19T11:04:22Z

Admin: 미네르바 스킨 메뉴 css

/* All CSS here will be loaded for users of the MinervaNeue skin */
/* 가온 위키 미네르바 전용 메뉴 스타일 */

/* 상위 그룹(게시판 / 버그/기능 개선 / 도구 / 도움말)의 헤더 */
.gaon-menu-header > a {
font-weight: bold;
}

/* 레벨별 들여쓰기 */
.gaon-menu-level2 {
margin-left: 1.5em;
}

.gaon-menu-level3 {
margin-left: 3em;
}

/* 하위 메뉴는 글자 크기를 조금 줄여 구분합니다. */
.gaon-menu-item-level2 > a span,
.gaon-menu-item-level3 > a span {
font-size: 0.95em;
}

/* 클릭 가능한 항목에 호버 시 약간의 배경 강조 */
.gaon-menu a:hover {
text-decoration: none;
background-color: rgba(0, 0, 0, 0.06);
}

/* 미네르바의 기존 메뉴 아이콘 스타일과 자연스럽게 이어지도록
아이콘과 텍스트 사이 간격 조정 (필요시 조정 가능) */
.gaon-menu a.mw-ui-icon.mw-ui-icon-before > span {
margin-left: 0.4em;
}

미디어위키:Minerva.js

2025-11-19T11:03:06Z

Admin: 미네르바 스킨 메뉴 추가

/* All JavaScript here will be loaded for users of the MinervaNeue skin */
/* 미네르바 노이에 전용 커스텀 메뉴 (PC/모바일 공통)
* MediaWiki:Minerva.js 에 넣는 것을 기준으로 작성되었습니다.
* 이 스크립트는 미네르바 스킨의 햄버거 메뉴 안에
* "게시판 / 버그/기능 개선 / 도구 / 도움말" 메뉴와 하위 메뉴를 추가합니다.
*/

( function ( mw, $ ) {
'use strict';

// 미네르바 스킨이 아닐 경우 아무 것도 하지 않는다.
if ( mw.config.get( 'skin' ) !== 'minerva' ) {
return;
}

/* -----------------------------
* 1. 메뉴 설정 (질문에서 주신 구조 그대로)
* ----------------------------- */

// 미네르바에서 사용할 아이콘 클래스는
// https://www.mediawiki.org/wiki/Topic:Vqy1kx6q4e0bzvyb 등에서 정리된 목록에 기반합니다. :contentReference[oaicite:5]{index=5}
// 필요하면 iconClass 값을 수정하여 원하는 아이콘으로 교체하면 됩니다.

var gaonMenuConfig = [
{
// * icon=comments | display=게시판
label: '게시판',
iconClass: 'mw-ui-icon-minerva-speechBubbles',
children: [
// ** icon=pencil-alt | display=위키방 | link=https://bbs.gaonwiki.com | title=https://bbs.gaonwiki.com
{
label: '위키방',
href: 'https://bbs.gaonwiki.com',
title: 'https://bbs.gaonwiki.com',
iconClass: 'mw-ui-icon-minerva-speechBubbles'
},
// ** icon=copyright | display=저작권 처리 게시판 | link=https://bbs.gaonwiki.com/copyrights | title=https://bbs.gaonwiki.com/copyrights
{
label: '저작권 처리 게시판',
href: 'https://bbs.gaonwiki.com/copyrights',
title: 'https://bbs.gaonwiki.com/copyrights',
iconClass: 'mw-ui-icon-minerva-speechBubbles'
},
// ** icon=comments | display=자유게시판 | link=https://bbs.gaonwiki.com/free | title=https://bbs.gaonwiki.com/free
{
label: '자유게시판',
href: 'https://bbs.gaonwiki.com/free',
title: 'https://bbs.gaonwiki.com/free',
iconClass: 'mw-ui-icon-minerva-speechBubbles'
}
]
},
{
// * icon=exclamation | display=버그/기능 개선
label: '버그/기능 개선',
iconClass: 'mw-ui-icon-minerva-die', // 경고/이슈 느낌의 주사위 아이콘 사용 예시
children: [
// ** icon=bullhorn | display=이슈 등록 | link=https://bbs.gaonwiki.com/issue | title=https://bbs.gaonwiki.com/issue
{
label: '이슈 등록',
href: 'https://bbs.gaonwiki.com/issue',
title: 'https://bbs.gaonwiki.com/issue',
iconClass: 'mw-ui-icon-minerva-die'
},
// ** icon=hands-helping | display=기능 구현 도움 | link=... | title=...
{
label: '기능 구현 도움',
href: 'https://www.gaonwiki.com/w/%EA%B0%80%EC%98%A8_%EC%9C%84%ED%82%A4:%EA%B8%B0%EB%8A%A5_%EA%B5%AC%ED%98%84_%EB%B6%88%EA%B0%80-%EB%88%84%EA%B0%80_%ED%95%B4%EA%B2%B0%EC%B1%85%EC%9D%84_%EC%95%8C%EB%A0%A4%EC%A3%BC%EC%84%B8%EC%9A%94!',
title: 'https://www.gaonwiki.com/w/가온_위키:기능_구현_불가-누가_해결책을_알려주세요!',
iconClass: 'mw-ui-icon-wikimedia-edit-base20'
},
// ** icon=bug | display=알려진 문제들 | link=... | title=...
{
label: '알려진 문제들',
href: 'https://www.gaonwiki.com/w/%EA%B0%80%EC%98%A8_%EC%9C%84%ED%82%A4/%EC%95%8C%EB%A0%A4%EC%A7%84_%EB%AC%B8%EC%A0%9C%EB%93%A4',
title: 'https://www.gaonwiki.com/w/가온_위키/알려진_문제들',
iconClass: 'mw-ui-icon-wikimedia-history-base20'
}
]
},
{
// * icon=gear | display=도구
label: '도구',
iconClass: 'mw-ui-icon-minerva-settings',
children: [
// ** icon=wrench | display=특수 문서 목록 | link=특수:특수문서 | title=특수:특수문서
{
label: '특수 문서 목록',
// mw.util.getUrl 을 사용하면 위키 내 링크를 환경에 맞게 자동으로 생성합니다.
href: mw.util.getUrl( '특수:특수문서' ),
title: '특수:특수문서',
iconClass: 'mw-ui-icon-minerva-settings'
},
// ** icon=upload | display=파일 올리기
{
label: '파일 올리기',
href: '#', // 상위 항목은 드롭다운용이므로 실제 링크는 서브 메뉴에 둡니다.
title: '파일 올리기',
iconClass: 'mw-ui-icon-minerva-download',
children: [
// *** icon=cloud-upload-alt | display=(기존) 업로드 | link=특수:올리기 | title=특수:올리기
{
label: '(기존) 업로드',
href: mw.util.getUrl( '특수:올리기' ),
title: '특수:올리기',
iconClass: 'mw-ui-icon-minerva-download'
},
// *** icon=file-upload | display=(신규) 업로드 마법사 | link=특수:UploadWizard | title=특수:UploadWizard
{
label: '(신규) 업로드 마법사',
href: mw.util.getUrl( '특수:UploadWizard' ),
title: '특수:UploadWizard',
iconClass: 'mw-ui-icon-minerva-download'
}
]
},
// ** icon=flag | display=이슈 트래커 | link=https://bbs.gaonwiki.com/issue/ | title=...
{
label: '이슈 트래커',
href: 'https://bbs.gaonwiki.com/issue/',
title: 'https://bbs.gaonwiki.com/issue/',
iconClass: 'mw-ui-icon-minerva-die'
},
// ** icon=flask | display=가온 위키 베타 | link=https://beta.gaonwiki.com | title=...
{
label: '가온 위키 베타',
href: 'https://beta.gaonwiki.com',
title: 'https://beta.gaonwiki.com',
iconClass: 'mw-ui-icon-minerva-mapPin'
}
]
},
{
// * icon=book | display=도움말
label: '도움말',
iconClass: 'mw-ui-icon-wikimedia-help-base20', // 도움말 느낌의 아이콘
children: [
// ** icon=spell-check | display=위키 문법 | link=도움말:위키_문법 | title=도움말:위키_문법
{
label: '위키 문법',
href: mw.util.getUrl( '도움말:위키_문법' ),
title: '도움말:위키_문법',
iconClass: 'mw-ui-icon-wikimedia-help-base20'
},
// ** icon=book | display=설명서 | link=도움말:설명서 | title=도움말:설명서
{
label: '설명서',
href: mw.util.getUrl( '도움말:설명서' ),
title: '도움말:설명서',
iconClass: 'mw-ui-icon-wikimedia-help-base20'
}
]
}
];

/* -----------------------------
* 2. DOM 유틸리티 함수
* ----------------------------- */

/**
* 하위 항목(2단계, 3단계)을 생성하고, 지정된 <ul> 안에 넣는 재귀 함수입니다.
*
* @param {jQuery} $ul 현재 레벨의 <ul> 요소(jQuery 객체)
* @param {Object} item 메뉴 항목 정의 (label, href, title, iconClass, children 등)
* @param {number} level 현재 레벨(2, 3 ...)
*/
function appendGaonMenuItem( $ul, item, level ) {
// <li> 생성
var $li = $( '<li>' )
.addClass( 'gaon-menu-item' )
.addClass( 'gaon-menu-item-level' + level );

// 실제 링크가 없고 드롭다운 전용인 항목이면 href 를 '#' 으로 둡니다.
var href = item.href || '#';

// <a> 생성 및 속성 설정
var $a = $( '<a>' )
.attr( 'href', href )
// title 이 지정되어 있으면 title 사용, 없으면 label 사용
.attr( 'title', item.title || item.label || '' )
// 미네르바 아이콘 스타일 적용
.addClass( 'mw-ui-icon mw-ui-icon-before' );

// 아이콘 클래스가 지정되어 있다면 추가
if ( item.iconClass ) {
$a.addClass( item.iconClass );
}

// 화면에 표시될 텍스트는 <span> 안에 넣습니다.
var $span = $( '<span>' ).text( item.label || '' );
$a.append( $span );

$li.append( $a );
$ul.append( $li );

// children 이 있다면 하위 <ul> 을 하나 더 만들어 재귀적으로 추가합니다.
if ( Array.isArray( item.children ) && item.children.length > 0 ) {
var nextLevel = level + 1;
var $subUl = $( '<ul>' )
.addClass( 'gaon-menu' )
.addClass( 'gaon-menu-level' + nextLevel );

item.children.forEach( function ( child ) {
appendGaonMenuItem( $subUl, child, nextLevel );
} );

// 여기서는 부모 <li> 아래에 중첩 <ul> 을 넣어 구조를 명확히 합니다.
$li.append( $subUl );
}
}

/**
* 상위 그룹(게시판, 버그/기능 개선 등)을 생성합니다.
* 각 그룹은 level1 <ul> 안에 헤더 <li> 와 하위 level2 <ul> 을 가지게 됩니다.
*
* @returns {jQuery} 햄버거 메뉴에 삽입할 상위 DOM 묶음(jQuery 객체)
*/
function buildGaonMenu() {
// 루트 컨테이너 역할을 할 <div> 를 하나 만든 뒤,
// 그 안에 여러 개의 <ul class="gaon-menu gaon-menu-level1"> 을 쌓습니다.
var $container = $( '<div>' ).addClass( 'gaon-menu-container' );

gaonMenuConfig.forEach( function ( group, index ) {
// 각 그룹마다 level1 <ul> 하나씩 생성
var $level1 = $( '<ul>' )
.addClass( 'gaon-menu' )
.addClass( 'gaon-menu-level1' )
.attr( 'data-gaon-group-index', index );

// 헤더(클릭 시 하위 level2 열고 닫는 부분) <li>
var $headerLi = $( '<li>' )
.addClass( 'gaon-menu-header' );

var $headerA = $( '<a>' )
// 상위 그룹은 토글 전용이므로 href="#" 로 두고 기본 동작을 막습니다.
.attr( 'href', '#' )
.attr( 'title', group.label || '' )
.addClass( 'mw-ui-icon mw-ui-icon-before' );

if ( group.iconClass ) {
$headerA.addClass( group.iconClass );
}

$headerA.append(
$( '<span>' ).text( group.label || '' )
);

$headerLi.append( $headerA );
$level1.append( $headerLi );

// 하위 메뉴(level2) 생성
if ( Array.isArray( group.children ) && group.children.length > 0 ) {
var $level2 = $( '<ul>' )
.addClass( 'gaon-menu' )
.addClass( 'gaon-menu-level2' );

group.children.forEach( function ( item ) {
appendGaonMenuItem( $level2, item, 2 );
} );

$level1.append( $level2 );
}

$container.append( $level1 );
} );

// 컨테이너 안의 자식 요소들만 반환합니다.
return $container.children();
}

/* -----------------------------
* 3. 메뉴를 미네르바 햄버거 메뉴 안에 삽입
* ----------------------------- */

/**
* 실제로 DOM 을 찾아서, 기본 메뉴 아래에 가온 메뉴를 삽입하는 함수입니다.
*/
function insertGaonMenuIntoMinerva() {
// 미네르바 햄버거 메뉴에서, 기존 최상위 <ul> 을 찾습니다.
// Qiita 예제에서는 '.menu ul:first' 를 기준으로 사용합니다. :contentReference[oaicite:6]{index=6}
var $firstUl = $( '.menu ul:first' );

if ( !$firstUl.length ) {
return;
}

// 중복 삽입 방지: 이미 가온 메뉴를 추가했으면 다시 하지 않습니다.
if ( $firstUl.data( 'gaonMenuInjected' ) ) {
return;
}
$firstUl.data( 'gaonMenuInjected', true );

// 우리의 메뉴 DOM 을 생성합니다.
var $gaonMenuNodes = buildGaonMenu();

// 기존 첫 번째 <ul> 바로 뒤에 삽입합니다.
$firstUl.after( $gaonMenuNodes );

// 하위 레벨 메뉴(level2, level3 …)는 기본적으로 숨겨 둡니다.
$( '.gaon-menu-level2, .gaon-menu-level3' ).hide();

// 상위 그룹(게시판 / 버그/기능 개선 / 도구 / 도움말) 클릭 시,
// 해당 그룹 내부의 level2 <ul> 을 토글합니다.
$( '.gaon-menu-header > a' ).on( 'click', function ( e ) {
e.preventDefault();

var $header = $( this );
var $level1 = $header.closest( '.gaon-menu-level1' );
var $level2 = $level1.children( '.gaon-menu-level2' );

$level2.slideToggle( 200 );
} );

// "파일 올리기" 같은 중간 단계에 children 이 있는 항목은
// 자신의 하위 level3 <ul> 을 토글합니다.
$( '.gaon-menu-item-level2 > a' ).each( function () {
var $a = $( this );
var $li = $a.closest( 'li' );
var $subUl = $li.children( '.gaon-menu-level3' );

if ( $subUl.length ) {
// children 이 있는 항목은 토글 버튼 역할을 하도록 클릭 핸들러를 붙입니다.
$a.on( 'click', function ( e ) {
e.preventDefault();
$subUl.slideToggle( 200 );
} );
}
} );
}

/* -----------------------------
* 4. 메뉴 DOM 생성 시점 기다리기
* ----------------------------- */

// 미네르바 메뉴 HTML 은 JS 로 동적으로 만들어지는 경우가 있기 때문에,
// DOM 이 준비될 때까지 주기적으로 검사하는 방식(Qiita 예제와 동일한 방식)을 사용합니다. :contentReference[oaicite:7]{index=7}

var maxAttempts = 50; // 최대 50번(약 5초)까지 시도
var attemptCount = 0;

function waitForMinervaMenu() {
var $firstUl = $( '.menu ul:first' );

if ( $firstUl.length ) {
// 메뉴를 찾았으면 바로 삽입 시도
insertGaonMenuIntoMinerva();
} else if ( attemptCount < maxAttempts ) {
attemptCount += 1;
setTimeout( waitForMinervaMenu, 100 );
}
}

// 문서 로드 이후에 검사 시작
$( waitForMinervaMenu );

}( mediaWiki, jQuery ) );

가온 위키:대문

2025-11-19T09:26:53Z

Admin: 공식 공지 추가

<div style="border-top: 8px solid #00BCD4; padding: 25px; box-shadow: 0 4px 12px rgba(0,0,0,0.1); text-align: center; border-radius: 12px; background: linear-gradient(135deg, #f8f9fa 0%, #ffffff 100%); margin-bottom: 20px;">
<div style="margin-bottom: 15px;">
<big style="font-size: 28px; font-weight: bold; color: #2c3e50;">모두의 <s style="color: #e74c3c;">마블</s>, 가온 위키!</big>
</div>

<p style="font-size: 20px; color: #34495e; margin: 10px 0;">[[가온 위키]]에 오신 것을<br><strong>환영합니다!</strong></p>

<div style="margin-top: 20px; padding: 15px; background-color: rgba(0, 188, 212, 0.1); border-radius: 8px;">
<big style="color: #00695c;">[[가온 위키]]는 누구든 참여할 수 있는 열린 위키입니다!</big>
</div>
</div>

<hr style="border: none; height: 3px; background: linear-gradient(to right, #00BCD4, #4CAF50); margin: 30px 0;" />

<div style="border: 2px solid #e1e8ed; border-radius: 12px; padding: 30px; background-color: #fafbfc; box-shadow: 0 2px 8px rgba(0,0,0,0.05);">
{| class="mw-collapsible" style="width: 100%; background: transparent;"
|+ style="font-size: 24px; font-weight: bold; color: #2c3e50; padding: 15px 0;" | 📢 공지사항
|-
| style="padding: 20px;" |
<div style="background: #fff; padding: 20px; border-radius: 8px; margin-bottom: 15px; border-left: 4px solid #00BCD4;">
'''[[클라우드플레어]] 서버 오류로 HTTP 500 에러 발생'''<br>
현재 전세계적으로 클라우드플레어 서버 오류로 인해 HTTP 500 에러가 발생하고 있습니다. 접속이 되었다 안되었다 하고 있는 상황입니다. 해결 될 때 까지 기다려 주시기 바랍니다. '''가온 위키 서버의 오류가 아닙니다.'''
[https://bbs.gaonwiki.com/4958 📋 상세 공지사항 확인하기]
</div>

<div style="background: #fff; padding: 20px; border-radius: 8px; margin-bottom: 15px; border-left: 4px solid #4CAF50;">
'''📖 사용법 안내'''<br>
위키 편집이 처음이신가요? [[도움말:위키 문법|위키 문법]]을 같이 배워봐요. 고급 사용자 이신가요? 새로운 문법, [[2023 문법 개선 프로젝트|📚 위키 사용법 가이드]]를 확인해보세요!
</div>

<div style="text-align: center; margin-top: 25px; padding: 15px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 8px;">
<span style="color: white; font-weight: bold;">💬 더 많은 정보가 필요하신가요?</span><br>
<span style="color: #f0f0f0;">[https://bbs.gaonwiki.com/notice 공지사항 게시판]에서 최신 소식을 확인하세요!</span>
</div>
|}
</div>

<div style="margin-top: 30px; text-align: center; padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 12px; color: white;">
<h3 style="margin: 0 0 15px 0;">🚀 위키 참여하기</h3>
<p style="margin: 0; opacity: 0.9;">지식을 공유하고, 함께 만들어가는 가온 위키의 일원이 되어보세요!</p>
</div>

가온 위키:대문

2025-11-18T12:48:12Z

Admin: 공지 업데이트(클라우드플레어 오류)

<div style="border-top: 8px solid #00BCD4; padding: 25px; box-shadow: 0 4px 12px rgba(0,0,0,0.1); text-align: center; border-radius: 12px; background: linear-gradient(135deg, #f8f9fa 0%, #ffffff 100%); margin-bottom: 20px;">
<div style="margin-bottom: 15px;">
<big style="font-size: 28px; font-weight: bold; color: #2c3e50;">모두의 <s style="color: #e74c3c;">마블</s>, 가온 위키!</big>
</div>

<p style="font-size: 20px; color: #34495e; margin: 10px 0;">[[가온 위키]]에 오신 것을<br><strong>환영합니다!</strong></p>

<div style="margin-top: 20px; padding: 15px; background-color: rgba(0, 188, 212, 0.1); border-radius: 8px;">
<big style="color: #00695c;">[[가온 위키]]는 누구든 참여할 수 있는 열린 위키입니다!</big>
</div>
</div>

<hr style="border: none; height: 3px; background: linear-gradient(to right, #00BCD4, #4CAF50); margin: 30px 0;" />

<div style="border: 2px solid #e1e8ed; border-radius: 12px; padding: 30px; background-color: #fafbfc; box-shadow: 0 2px 8px rgba(0,0,0,0.05);">
{| class="mw-collapsible" style="width: 100%; background: transparent;"
|+ style="font-size: 24px; font-weight: bold; color: #2c3e50; padding: 15px 0;" | 📢 공지사항
|-
| style="padding: 20px;" |
<div style="background: #fff; padding: 20px; border-radius: 8px; margin-bottom: 15px; border-left: 4px solid #00BCD4;">
'''[[클라우드플레어]] 서버 오류로 HTTP 500 에러 발생'''<br>
현재 전세계적으로 클라우드플레어 서버 오류로 인해 HTTP 500 에러가 발생하고 있습니다. 접속이 되었다 안되었다 하고 있는 상황입니다. 해결 될 때 까지 기다려 주시기 바랍니다. '''가온 위키 서버의 오류가 아닙니다.''' 19일 오후에 정리하여 공지하겠습니다.
[https://bbs.gaonwiki.com/4958 📋 상세 공지사항 확인하기]
</div>

<div style="background: #fff; padding: 20px; border-radius: 8px; margin-bottom: 15px; border-left: 4px solid #4CAF50;">
'''📖 사용법 안내'''<br>
위키 편집이 처음이신가요? [[도움말:위키 문법|위키 문법]]을 같이 배워봐요. 고급 사용자 이신가요? 새로운 문법, [[2023 문법 개선 프로젝트|📚 위키 사용법 가이드]]를 확인해보세요!
</div>

<div style="text-align: center; margin-top: 25px; padding: 15px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 8px;">
<span style="color: white; font-weight: bold;">💬 더 많은 정보가 필요하신가요?</span><br>
<span style="color: #f0f0f0;">[https://bbs.gaonwiki.com/notice 공지사항 게시판]에서 최신 소식을 확인하세요!</span>
</div>
|}
</div>

<div style="margin-top: 30px; text-align: center; padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 12px; color: white;">
<h3 style="margin: 0 0 15px 0;">🚀 위키 참여하기</h3>
<p style="margin: 0; opacity: 0.9;">지식을 공유하고, 함께 만들어가는 가온 위키의 일원이 되어보세요!</p>
</div>

가온 위키:대문

2025-05-27T12:31:41Z

Admin: 디자인 개선

<div style="border-top: 8px solid #00BCD4; padding: 25px; box-shadow: 0 4px 12px rgba(0,0,0,0.1); text-align: center; border-radius: 12px; background: linear-gradient(135deg, #f8f9fa 0%, #ffffff 100%); margin-bottom: 20px;">
<div style="margin-bottom: 15px;">
<big style="font-size: 28px; font-weight: bold; color: #2c3e50;">모두의 <s style="color: #e74c3c;">마블</s>, 가온 위키!</big>
</div>

<p style="font-size: 20px; color: #34495e; margin: 10px 0;">[[가온 위키]]에 오신 것을<br><strong>환영합니다!</strong></p>

<div style="margin-top: 20px; padding: 15px; background-color: rgba(0, 188, 212, 0.1); border-radius: 8px;">
<big style="color: #00695c;">[[가온 위키]]는 누구든 참여할 수 있는 열린 위키입니다!</big>
</div>
</div>

<hr style="border: none; height: 3px; background: linear-gradient(to right, #00BCD4, #4CAF50); margin: 30px 0;" />

<div style="border: 2px solid #e1e8ed; border-radius: 12px; padding: 30px; background-color: #fafbfc; box-shadow: 0 2px 8px rgba(0,0,0,0.05);">
{| class="mw-collapsible" style="width: 100%; background: transparent;"
|+ style="font-size: 24px; font-weight: bold; color: #2c3e50; padding: 15px 0;" | 📢 공지사항
|-
| style="padding: 20px;" |
<div style="background: #fff; padding: 20px; border-radius: 8px; margin-bottom: 15px; border-left: 4px solid #00BCD4;">
'''🔧 서버 점검 완료'''<br>
미디어위키 업그레이드 외 다양한 버그들을 수정했어요.
[https://bbs.gaonwiki.com/notice/4898 📋 상세 공지사항 확인하기]
</div>

<div style="background: #fff; padding: 20px; border-radius: 8px; margin-bottom: 15px; border-left: 4px solid #4CAF50;">
'''📖 사용법 안내'''<br>
위키 편집이 처음이신가요? [[도움말:위키 문법|위키 문법]]을 같이 배워봐요. 고급 사용자 이신가요? 새로운 문법, [[2023 문법 개선 프로젝트|📚 위키 사용법 가이드]]를 확인해보세요!
</div>

<div style="text-align: center; margin-top: 25px; padding: 15px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 8px;">
<span style="color: white; font-weight: bold;">💬 더 많은 정보가 필요하신가요?</span><br>
<span style="color: #f0f0f0;">[https://bbs.gaonwiki.com/notice 공지사항 게시판]에서 최신 소식을 확인하세요!</span>
</div>
|}
</div>

<div style="margin-top: 30px; text-align: center; padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 12px; color: white;">
<h3 style="margin: 0 0 15px 0;">🚀 위키 참여하기</h3>
<p style="margin: 0; opacity: 0.9;">지식을 공유하고, 함께 만들어가는 가온 위키의 일원이 되어보세요!</p>
</div>

도움말:위키 문법/5단계

2025-02-16T06:39:39Z

Admin: 시작

{{틀:위키프로젝트}}
{{틀:위키도움이}}

{{틀:위키 문법 단계}}

== 5단계: 고급 커스터마이징 ==
이 단계에서는 위키의 고급 기능들을 활용하여 더욱 전문적인 문서 작성 방법을 다룹니다. 파서 함수의 심화 사용법과 사용자 정의 서식 적용 방법을 배우게 됩니다.

== 1. 심화 파서 함수 ==
=== 수식 계산 (expr) ===
수학적 계산을 직접 문서에서 수행할 수 있습니다.

기본 문법:
<pre>
{{#expr: 수식}}
</pre>

예시:
* '''기본 연산:''' {{#expr: 2 + 3 * 4}}
* '''소수점 처리:''' {{#expr: (23/7) round 2}}
* '''절대값:''' {{#expr: abs(-3.5)}}

==== 지원하는 수학 함수 ====
* '''round''' - 반올림
* '''ceil''' - 올림
* '''floor''' - 내림
* '''abs''' - 절대값
* '''sin''', '''cos''', '''tan''' - 삼각함수
* '''exp''', '''ln''' - 지수/로그함수

=== 복잡한 논리 연산 ===
여러 조건을 조합하여 사용할 수 있습니다.

==== and/or 연산자 ====
<pre>
{{#if: {{#expr: 조건1 and 조건2}}
| 두 조건 모두 참일 때
| 하나라도 거짓일 때
}}
</pre>

예시:
<pre>
{{#if: {{#expr: (2 > 1) and (3 < 4)}}
| 수식이 참입니다
| 수식이 거짓입니다
}}
</pre>

== 2. 고급 템플릿 기법 ==
=== 재귀적 템플릿 ===
템플릿이 자기 자신을 호출하는 방식입니다.

예시 - 리스트 생성:
<pre>
{{#리스트생성
| 항목1
| 항목2
| 항목3
}}
</pre>

=== 기본값 설정 ===
템플릿 매개변수의 기본값을 지정할 수 있습니다.

<pre>
{{{매개변수|기본값}}}
</pre>

예시:
<pre>
{{인사말
| 이름={{{1|방문자}}}
| 메시지={{{2|환영합니다}}}
}}
</pre>

== 3. 사용자 정의 CSS ==
=== 인라인 스타일 ===
HTML 요소에 직접 스타일을 적용합니다.

==== div 요소 스타일링 ====
<pre>
<div style="
background-color: #f0f0f0;
border: 1px solid #ccc;
padding: 15px;
margin: 10px 0;
border-radius: 5px;
">
내용을 여기에 작성합니다
</div>
</pre>

==== 글자 스타일링 ====
<pre>
<span style="
color: #2196F3;
font-weight: bold;
text-decoration: underline;
">
강조된 텍스트
</span>
</pre>

=== 고급 레이아웃 ===
==== 플렉스박스 레이아웃 ====
<pre>
<div style="
display: flex;
justify-content: space-between;
align-items: center;
">
<div>왼쪽 내용</div>
<div>오른쪽 내용</div>
</div>
</pre>

==== 그리드 레이아웃 ====
<pre>
<div style="
display: grid;
grid-template-columns: 1fr 1fr;
gap: 20px;
">
<div>첫 번째 칸</div>
<div>두 번째 칸</div>
<div>세 번째 칸</div>
<div>네 번째 칸</div>
</div>
</pre>

== 주의사항 ==
* 수식 계산에서 0으로 나누기 등 잘못된 연산을 주의하세요.
* 재귀적 템플릿은 무한 루프에 빠지지 않도록 제한 조건을 꼭 설정하세요.
* CSS 스타일은 위키의 보안 정책에 따라 일부 속성이 제한될 수 있습니다.
* 복잡한 레이아웃은 모바일 기기에서의 표시를 고려해야 합니다.

== 고급 기능 활용 예시 ==
=== 동적 테이블 생성 ===
수식과 조건문을 활용한 동적 테이블 예시:
<pre>
{| class="wikitable"
! 숫자 !! 제곱 !! 상태
|-
{{#loop: 1 | 5 |
| {{#var:i}}
| {{#expr: {{#var:i}} * {{#var:i}}}}
| {{#if: {{#expr: {{#var:i}} mod 2 = 0}}
| 짝수
| 홀수
}}
|-
}}
|}
</pre>

== 연습하기 ==
[[위키백과:연습장|연습장]]에서 다음 기능들을 연습해보세요:
* 수식 계산기 만들기
* 재귀적 목록 생성
* 고급 CSS 레이아웃 구현
* 조건부 템플릿 작성

도움말:위키 문법/4단계

2025-02-16T06:33:39Z

Admin: 리뉴얼

{{틀:위키프로젝트}}
{{틀:위키도움이}}

{{틀:위키 문법 단계}}

== 4단계: 템플릿과 파서 함수 ==
템플릿과 파서 함수를 사용하면 문서를 더욱 동적이고 효율적으로 관리할 수 있습니다. 이 단계에서는 템플릿의 기본 사용법부터 고급 파서 함수까지 다룹니다.

== 1. 템플릿 기본 ==
=== 템플릿 호출 ===
템플릿은 미리 정의된 내용을 여러 문서에서 재사용할 수 있게 해주는 기능입니다.

기본 문법:
<pre>
{{템플릿명}}
</pre>

예시:
* {{환영}} - 새 사용자 환영 메시지 표시
* {{인용}} - 인용구 서식 적용

=== 매개변수 사용 ===
템플릿에 값을 전달하여 더 유연하게 사용할 수 있습니다.

==== 순서 기반 매개변수 ====
<pre>
{{템플릿명|첫번째값|두번째값|세번째값}}
</pre>

예시:
* {{인용|작성자|내용|출처}}

==== 이름 지정 매개변수 ====
<pre>
{{템플릿명|매개변수1=값1|매개변수2=값2}}
</pre>

예시:
* {{책 정보|제목=위키의 이해|저자=홍길동|출판년도=2024}}

== 2. 파서 함수 ==
=== 조건문 (if) ===
조건에 따라 다른 내용을 표시할 수 있습니다.

기본 문법:
<pre>
{{#if: 조건
| 조건이 참일 때 표시할 내용
| 조건이 거짓일 때 표시할 내용
}}
</pre>

예시:
<pre>
{{#if: {{PAGENAME}}
| 현재 문서 제목: {{PAGENAME}}
| 문서 제목을 찾을 수 없습니다
}}
</pre>

=== 선택문 (switch) ===
여러 조건에 따른 분기 처리가 가능합니다.

기본 문법:
<pre>
{{#switch: 비교할값
| 값1 = 결과1
| 값2 = 결과2
| #default = 기본결과
}}
</pre>

예시:
<pre>
{{#switch: {{CURRENTDAYNAME}}
| 월요일 = 새로운 한 주의 시작입니다
| 금요일 = 즐거운 주말 시작!
| #default = 평일입니다
}}
</pre>

== 3. Magic Words ==
=== 기본 변수 ===
시스템에서 제공하는 특별한 변수들입니다.

주요 Magic Words:
* '''{{CURRENTTIME}}''' - 현재 시간
* '''{{CURRENTDATE}}''' - 현재 날짜
* '''{{CURRENTYEAR}}''' - 현재 연도
* '''{{PAGENAME}}''' - 현재 문서 이름
* '''{{FULLPAGENAME}}''' - 전체 문서 경로
* '''{{NAMESPACE}}''' - 현재 이름공간

=== 날짜/시간 관련 변수 ===
* '''{{CURRENTDAYNAME}}''' - 현재 요일
* '''{{CURRENTMONTHNAME}}''' - 현재 월
* '''{{CURRENTTIMESTAMP}}''' - 현재 타임스탬프

== 4. 고급 템플릿 기법 ==
=== 중첩 템플릿 ===
템플릿 안에 다른 템플릿을 포함할 수 있습니다.

<pre>
{{템플릿1|매개변수={{템플릿2|값}}}}
</pre>

=== 템플릿 변수 ===
템플릿 내에서 지역 변수를 사용할 수 있습니다.

<pre>
{{{변수명|기본값}}}
</pre>

== 주의사항 ==
* 템플릿을 과도하게 중첩하면 성능이 저하될 수 있습니다.
* 파서 함수의 조건문에서는 빈 문자열이 거짓으로 처리됩니다.
* Magic Words는 대소문자를 구분합니다.
* 템플릿 매개변수 전달 시 공백에 주의해야 합니다.

== 연습하기 ==
[[가온 위키:연습장|연습장]]에서 다음 작업을 연습해보세요:
* 간단한 템플릿 만들기
* 조건문을 사용한 내용 분기
* Magic Words를 활용한 동적 정보 표시
* 중첩 템플릿 사용하기

도움말:위키 문법/3단계

2025-02-16T06:22:43Z

Admin: 리뉴얼

{{틀:위키프로젝트}}
{{틀:위키도움이}}

{{틀:위키 문법 단계}}

== 1. 내부 링크 세부 기능 ==
=== 섹션 링크 ===
문서 내의 특정 섹션으로 직접 이동하는 링크를 만들 수 있습니다.

기본 문법:
<pre>
[[문서명#섹션명]]
[[문서명#섹션명|다른 이름으로 표시]]
</pre>

예시:
* [[위키 문법#기본 사용법]]
* [[위키 문법#기본 사용법|문법 설명 보기]]

'''주의:''' 섹션 이름은 대소문자를 구분하며, 정확히 일치해야 합니다.

=== 하위 섹션 링크 ===
<pre>
[[문서명#상위섹션명#하위섹션명]]
</pre>

== 2. 각주 사용하기 ==
각주를 사용하여 문서에 참조나 설명을 추가할 수 있습니다.

=== 기본 각주 ===
<pre>
이것은 각주가 필요한 문장입니다.<ref>각주 내용을 여기에 작성합니다.</ref>

== 각주 ==
<references />
</pre>

=== 이름 있는 각주 ===
같은 각주를 여러 번 사용할 때 유용합니다.
<pre>
첫 번째 사용<ref name="참고1">공통된 각주 내용</ref>
다시 같은 각주 사용<ref name="참고1" />
</pre>

=== 그룹화된 각주 ===
<pre>
일반 각주<ref>일반 내용</ref>
그룹 각주<ref group="주석">주석 내용</ref>

== 각주 ==
=== 일반 각주 ===
<references />
=== 주석 ===
<references group="주석" />
</pre>

== 3. 고급 표 작성 ==
=== 셀 병합 ===
표의 셀을 가로나 세로로 병합할 수 있습니다.

예시:
<pre>
{| class="wikitable"
|+ 병합 셀 예시
! 열 1 !! colspan="2" | 병합된 열 제목
|-
| 행 1 || 내용 1 || 내용 2
|-
| rowspan="2" | 병합된 행 || 내용 3 || 내용 4
|-
| 내용 5 || 내용 6
|}
</pre>

결과:
{| class="wikitable"
|+ 병합 셀 예시
! 열 1 !! colspan="2" | 병합된 열 제목
|-
| 행 1 || 내용 1 || 내용 2
|-
| rowspan="2" | 병합된 행 || 내용 3 || 내용 4
|-
| 내용 5 || 내용 6
|}

=== 셀 서식 ===
셀별로 다양한 스타일을 적용할 수 있습니다.

<pre>
{| class="wikitable"
! style="background-color: #ffeb3b; width: 30%;" | 노란 배경
! style="text-align: center; width: 40%;" | 가운데 정렬
! style="color: red;" | 빨간 글씨
|-
| style="vertical-align: top;" | 상단 정렬
| style="padding: 20px;" | 여백 늘리기
| style="border: 2px solid blue;" | 테두리 강조
|}
</pre>

== 4. 고급 목록 ==
=== 복합 목록 ===
여러 종류의 목록을 조합하여 사용할 수 있습니다.

<pre>
* 대분류 1
*# 순서 있는 하위 목록 1
*# 순서 있는 하위 목록 2
** 순서 없는 하위 목록
*#* 혼합된 하위 목록 1
*#* 혼합된 하위 목록 2
* 대분류 2
*; 정의 목록 용어
*: 정의 목록 설명
</pre>

결과:
* 대분류 1
*# 순서 있는 하위 목록 1
*# 순서 있는 하위 목록 2
** 순서 없는 하위 목록
*#* 혼합된 하위 목록 1
*#* 혼합된 하위 목록 2
* 대분류 2
*; 정의 목록 용어
*: 정의 목록 설명

== 5. CSS 스타일링 ==
=== 인라인 스타일 ===
HTML 태그와 CSS를 사용하여 세밀한 스타일을 적용할 수 있습니다.

<pre>
<div style="background-color: #f0f0f0; padding: 10px; border: 1px solid #ccc; margin: 10px 0;">
박스 형태의 내용입니다.
</div>

<span style="color: blue; font-weight: bold;">강조된 텍스트</span>
</pre>

=== 자주 사용하는 스타일 속성 ===
* '''text-align:''' left, right, center, justify
* '''color:''' 글자 색상
* '''background-color:''' 배경 색상
* '''padding:''' 내부 여백
* '''margin:''' 외부 여백
* '''border:''' 테두리
* '''width:''' 너비
* '''height:''' 높이

== 주의사항 ==
* 각주는 본문에서 처음 사용된 순서대로 번호가 매겨집니다.
* 표의 셀을 병합할 때는 전체 구조를 미리 계획하는 것이 좋습니다.
* CSS 스타일은 위키의 정책에 따라 제한될 수 있습니다.
* 복잡한 목록은 가독성을 고려하여 적절한 들여쓰기를 사용하세요.

== 연습하기 ==
[[가온 위키:연습장|연습장]]에서 위의 문법들을 실제로 사용해보면서 익숙해지세요. 특히 표 병합과 각주는 많은 연습이 필요할 수 있습니다.

도움말:위키 문법/2단계

2025-02-16T05:50:03Z

Admin: 리뉴얼

{{틀:위키프로젝트}}
{{틀:위키도움이}}

{{틀:위키 문법 단계}}

1단계 문법을 기반으로 더 다양한 기능을 사용하는 방법을 설명합니다. 이 문서에서 다루는 문법들은 문서를 더 풍부하고 체계적으로 만드는 데 도움이 됩니다.

== 1. 파일과 이미지 ==
이미지나 다른 파일을 문서에 삽입할 수 있습니다.

=== 기본 문법 ===
<pre>
[[파일:파일명.확장자|옵션]]
</pre>

=== 자주 사용하는 옵션 ===
* '''thumb''' - 섬네일 형식으로 표시
* '''right''', '''left''', '''center''' - 정렬 방식
* '''300px''' - 크기 지정 (숫자는 변경 가능)
* '''설명글''' - 이미지 아래에 표시될 설명

입력 예시:
<pre>
[[파일:예시이미지.jpg|thumb|300px|right|이미지 설명]]
[[파일:문서.pdf|문서 다운로드]]
</pre>

'''팁:''' 여러 옵션을 동시에 사용할 때는 파이프(|)로 구분합니다.

== 2. 표 만들기 ==
표를 만들어 정보를 체계적으로 정리할 수 있습니다.

=== 기본 표 구조 ===
<pre>
{| class="wikitable"
|+ 표 제목
! 열 제목 1 !! 열 제목 2
|-
| 내용 1 || 내용 2
|-
| 내용 3 || 내용 4
|}
</pre>

결과:
{| class="wikitable"
|+ 표 제목
! 열 제목 1 !! 열 제목 2
|-
| 내용 1 || 내용 2
|-
| 내용 3 || 내용 4
|}

=== 표 요소 설명 ===
* '''{|''' - 표 시작
* '''|+''' - 표 제목 (선택사항)
* '''!''' - 열 제목 (머리글)
* '''|-''' - 새로운 행
* '''|''' - 일반 셀
* '''||''' - 같은 행의 다음 셀
* '''|}''' - 표 끝

=== 셀 속성 지정 ===
<pre>
{| class="wikitable"
! style="background-color: #ffeb3b;" | 노란 배경
| style="text-align: center;" | 가운데 정렬
|}
</pre>

'''팁:''' class="wikitable"를 추가하면 기본 테두리와 스타일이 적용됩니다.

== 3. 템플릿 사용 ==
자주 사용하는 내용을 템플릿으로 만들어 재사용할 수 있습니다.

=== 기본 호출 ===
<pre>
{{템플릿이름}}
</pre>

=== 매개변수 사용 ===
<pre>
{{템플릿이름|매개변수1=값1|매개변수2=값2}}
</pre>

'''예시:'''
* '''날짜 템플릿:''' {{날짜/출력|2025-01-01}}
* '''정보상자:''' {{정보상자|제목=위키 문법|종류=도움말}}

== 4. 분류 지정 ==
문서를 특정 주제별로 분류하여 관리할 수 있습니다.

=== 기본 분류 ===
<pre>
[[분류:주제명]]
</pre>

=== 다중 분류 ===
<pre>
[[분류:프로그래밍]]
[[분류:도움말]]
[[분류:위키 문법]]
</pre>

'''팁:''' 분류는 보통 문서의 맨 아래에 넣습니다.

== 5. 주석 사용 ==
편집할 때만 보이는 설명을 추가할 수 있습니다.

=== HTML 주석 ===
<pre>

</pre>

=== 긴 주석 예시 ===
<pre>

</pre>

== 6. HTML 태그 활용 ==
기본적인 HTML 태그를 사용하여 추가 서식을 적용할 수 있습니다.

=== 자주 사용하는 태그 ===
* '''<nowiki><div></nowiki>''' - 블록 레벨 요소
* '''<nowiki><span></nowiki>''' - 인라인 요소
* '''<nowiki><blockquote></nowiki>''' - 인용문
* '''<nowiki><code></nowiki>''' - 코드 표시
* '''<nowiki><sub></nowiki>''' - 아래 첨자
* '''<nowiki><sup></nowiki>''' - 위 첨자

입력 예시:
<pre>
<div style="background-color: #f0f0f0; padding: 10px;">
박스 안의 내용입니다.
</div>

<blockquote>
인용된 텍스트입니다.
</blockquote>

H<sub>2</sub>O는 물의 화학식입니다.
</pre>

결과:
<div style="background-color: #f0f0f0; padding: 10px;">
박스 안의 내용입니다.
</div>

<blockquote>
인용된 텍스트입니다.
</blockquote>

H<sub>2</sub>O는 물의 화학식입니다.

== 주의사항 ==
* HTML 태그는 보안상의 이유로 일부만 허용됩니다.
* 기본적으로 위키 문서 수정 시에는 HTML 태그 사용이 아닌, 기본 미디어위키 문법만을 사용하는 것을 권장합니다.
* 복잡한 표는 단계적으로 만들면서 결과를 확인하는 것이 좋습니다.
* 템플릿을 만들 때는 문서에서 직접 테스트해보세요.
* 파일을 올릴 때는 적절한 라이선스를 확인해야 합니다.

== 연습하기 ==
[[가온 위키:연습장|연습장]]에서 위의 문법들을 실제로 사용해보면서 익숙해지세요. 특히 표 만들기는 처음에는 어려울 수 있으니 차근차근 연습하시기 바랍니다.

도움말:위키 문법/1단계

2025-02-16T05:30:44Z

Admin: 리뉴얼

{{틀:위키프로젝트}}
{{틀:위키도움이}}

{{틀:위키 문법 단계}}

위키 문법의 가장 기초적이고 자주 사용되는 요소들을 설명합니다. 이 문서에서 다루는 문법들은 위키 편집에서 가장 빈번하게 사용되는 핵심 기능들입니다.

== 1. 문단 구분 ==
문단을 구분하려면 엔터키를 두 번 눌러 빈 줄을 삽입합니다.

입력 예시:
<pre>
첫 번째 문단입니다.
이렇게 한 번만 줄바꿈하면 같은 문단으로 처리됩니다.

두 번째 문단입니다.
엔터를 두 번 쳐서 새로운 문단을 만들었습니다.
</pre>

결과:
첫 번째 문단입니다.
이렇게 한 번만 줄바꿈하면 같은 문단으로 처리됩니다.

두 번째 문단입니다.
엔터를 두 번 쳐서 새로운 문단을 만들었습니다.

== 2. 제목 만들기 ==
등호(=)를 사용하여 제목의 단계를 표시합니다. 등호는 양쪽에 같은 개수로 입력합니다.

입력 예시:
<pre>
== 2단계 제목 ==
=== 3단계 제목 ===
==== 4단계 제목 ====
===== 5단계 제목 =====
</pre>

결과:
=== 3단계 제목 ===
==== 4단계 제목 ====
===== 5단계 제목 =====

'''참고:''' 1단계 제목(=)은 문서의 제목으로 사용되므로, 본문에서는 2단계 제목부터 사용하는 것이 좋습니다.

== 3. 글자 서식 ==
작은따옴표(')를 사용하여 글자의 서식을 지정할 수 있습니다.

입력 예시:
<pre>
''기울임체''
'''굵은 글씨'''
'''''굵은 기울임체'''''
</pre>

결과:
''기울임체''
'''굵은 글씨'''
'''''굵은 기울임체'''''

== 4. 목록 만들기 ==
별표(*)나 샵(#)을 사용하여 목록을 만들 수 있습니다.

입력 예시:
<pre>
* 순서 없는 목록
* 두 번째 항목
** 들여쓴 항목
** 다른 들여쓴 항목
* 다시 첫 수준

# 순서 있는 목록
# 두 번째 항목
## 들여쓴 항목
## 다른 들여쓴 항목
# 다시 첫 수준

* 혼합 목록
*# 순서 있는 하위 항목
*# 두 번째 순서 항목
* 다시 순서 없는 목록
</pre>

결과:
* 순서 없는 목록
* 두 번째 항목
** 들여쓴 항목
** 다른 들여쓴 항목
* 다시 첫 수준

# 순서 있는 목록
# 두 번째 항목
## 들여쓴 항목
## 다른 들여쓴 항목
# 다시 첫 수준

* 혼합 목록
*# 순서 있는 하위 항목
*# 두 번째 순서 항목
* 다시 순서 없는 목록

== 5. 링크 만들기 ==
=== 내부 링크 ===
대괄호([])를 사용하여 다른 위키 문서로 연결하는 링크를 만듭니다.

입력 예시:
<pre>
[[문서 이름]]
[[문서 이름|다른 이름으로 표시]]
</pre>

결과:
[[문서 이름]]
[[문서 이름|다른 이름으로 표시]]

=== 외부 링크 ===
한 개의 대괄호를 사용하여 외부 웹사이트로 연결하는 링크를 만듭니다.

입력 예시:
<pre>
[https://www.example.com]
[https://www.example.com 예시 웹사이트]
</pre>

결과:
[https://www.example.com]
[https://www.example.com 예시 웹사이트]

== 6. 수평선 ==
하이픈(-)을 4개 이상 연속해서 입력하면 수평선이 생성됩니다.

입력 예시:
<pre>
문단 1
----
문단 2
</pre>

결과:
문단 1
----
문단 2

== 7. 목차 제어 ==
문서에 제목이 4개 이상 있으면 자동으로 목차가 생성됩니다. 다음 매직워드를 사용하여 목차를 제어할 수 있습니다:

* __TOC__ : 이 위치에 목차를 강제로 표시
* __NOTOC__ : 목차를 숨김

'''참고:''' 목차는 모든 제목을 포함하며, 문서의 구조를 한눈에 파악하는데 도움이 됩니다.

== 기타 도움말 ==
* 문법은 대소문자를 구분하지 않습니다(예: ''text''와 ''TEXT''는 동일하게 작동)
* 여러 문법을 조합해서 사용할 수 있습니다(예: '''[[링크된 굵은 텍스트]]''')
* 문서 시작 부분에 간단한 소개나 설명을 넣는 것이 좋습니다
* 제목은 계층 구조를 지켜서 사용하세요(2단계 다음에 4단계를 쓰는 것은 피하세요)

== 연습하기 ==
위의 문법들을 실제로 사용해보면서 익숙해지는 것이 중요합니다. [[가온 위키:연습장|연습장]]에서 다양하게 시도해보세요.

마크다운

2025-02-09T12:50:26Z

Admin: /* H1~H6 */ html 태그 적용이 되는 문제 수정

[[파일:Markdown-mark.svg|150px]]
<s>마크다운 = 마(인)크(래프트) 다운(로드)</s>
==개요==
텍스트 기반의 마크업 언어로, 2004년 존 그루버가 만들었다. 위키에서는 그 위키 엔진에서 제공하는 문법으로 작성해야 원하는 모양으로 표시 할 수 있는 것처럼, 마크다운이라는 문법 체계에 맞춰 작성하면 '''굵게''' 하거나, ''기울이기'' 등을 적용할 수 있다.

널리 퍼지게 된 때는 깃허브에서 마크다운을 사용하기 시작하면서 간단하게 작성하면서 가독성이 높은 문서를 작성할 수 있어서 널리 퍼지게 되었다.
==특징==
문법이 간결하며, [[CKEditor]]와 같이 에디터가 없더라도 마크다운을 작성할 수 있으며, 에디터로 작성하는 것이 아닌 텍스트로 저장이 되기에 차지하는 용량이 적다는 장점이 있다.

또한 텍스트 이기에 깃허브와 같이 버전 관리 시스템에서 변경사항을 확인할 수 있다.

하지만 '''표준이 없기에''' 변환 체계에 따라 결과물이 달라질 수 있으며, 모든 [[HTML]]을 대체할 수 없고, 몇몇 문법에서는 세세한 조절 또한 불가능 하기에 HTML 태그를 이용해야 한다는 단점이 있다.

표준이 없으므로 마크다운을 사용하는 곳이더라도 같은 태그로 사용하더라도 지원하지 않는 곳도 있기에 확인이 필요하다.
==문법==
마크다운 문법, HTML 문법, 위키 문법, 결과물 순으로 작성하며, 위키에서는 마크다운 문법을 지원하지 않기에 위키 문법이나 HTML 문법으로 출력시킵니다.
==H1~H6==
{| class="wikitable"
|-
| <syntaxhighlight>
# This is a H1
## This is a H2
### This is a H3
#### This is a H4
##### This is a H5
###### This is a H6
</syntaxhighlight>
| <syntaxhighlight lang='html'>
<h1>This is a H1</h1>
<h2>This is a H2</h2>
<h3>This is a H3</h3>
<h4>This is a H4</h4>
<h5>This is a H5</h5>
<h6>This is a H6</h6>
</syntaxhighlight>
|-
! 마크다운 문법
! HTML 문법
|-
| <syntaxhighlight>
= This is a H1 =
== This is a H2 ==
=== This is a H3 ===
==== This is a H4 ====
===== This is a H5 =====
====== This is a H6 ======
</syntaxhighlight>
| [[파일:마크다운_문법_heading.png]]
|-
! 위키 문법
! 결과
|}
HTML에서 heading 태그가 <code><nowiki><h6></h6></nowiki></code>까지 있기에 마크다운 또한 h6까지만 지원한다. 즉, h7은 없다.
===목록===
====Unordered Lists====
{| class="wikitable"
|-
| <syntaxhighlight>
* 봄
* 여름
* 가을
* 겨울

- 봄
- 여름
- 가을
- 겨울

+ 봄
+ 여름
+ 가을
+ 겨울

* 봄
+ 여름
- 가을
* 겨울
</syntaxhighlight>
| <syntaxhighlight lang='html'>
<ul>
<li>봄</li>
<ul>
<li>여름</li>
<ul>
<li>가을</li>
<ul>
<li>겨울</li>
</ul>
</ul>
</ul>
</li>
</ul>
</syntaxhighlight>
|-
! 마크다운 문법
! HTML 문법
|-
| <syntaxhighlight>
* 봄
** 여름
*** 가을
**** 겨울
</syntaxhighlight>
|
* 봄
** 여름
*** 가을
**** 겨울
|-
! 위키 문법
! 결과
|}
'''<code>*</code>''', '''<code>+</code>''', '''<code>-</code>'''를 혼합해서 사용해도 상관없다.
====Ordered Lists====
{| class="wikitable"
|-
| <syntaxhighlight>
1. 가나다
2. 라마바
3. 사아자

1. 가나다
3. 라마바
2. 사아자
</syntaxhighlight>
| <syntaxhighlight lang='html'>
<ol>
<li>가나다</li>
<li>라마바</li>
<li>사아자</li>
</ol>
</syntaxhighlight>
|-
! 마크다운 문법
! HTML 문법
|-
| <syntaxhighlight>
# 가나다
# 라마바
# 사아자
</syntaxhighlight>
|
# 가나다
# 라마바
# 사아자
|-
! 위키 문법
! 결과
|}
마크다운에서는 순번을 정하면 내림차순으로 출력하기 때문에 1, 3, 4, 2 순으로 해도 1, 2, 3, 4 순으로 내용값은 바뀜 없이 출력이 된다.
===hr(구분선)===
{| class="wikitable"
|-
| <syntaxhighlight>
가나다라마바사
- - -
아자차카타파하

가나다라마바사
***
아자차카타파하

가나다라마바사
*****
아자차카타파하

가나다라마바사
* * *
아자차카타파하

가나다라마바사
-----
아자차카타파하
</syntaxhighlight>
| <syntaxhighlight lang='html'>
<p>가나다라마바사</p>
<hr/>
<p>아자차카타파하</p>
</syntaxhighlight>
|-
! 마크다운 문법
! HTML 문법
|-
| <syntaxhighlight>
가나다라마바사
<hr/>
아자차카타파하
</syntaxhighlight>
|
가나다라마바사
<hr/>
아자차카타파하
|-
! 위키 문법
! 결과
|}
<code>-</code>(마이너스 키)의 갯수와 상관 없이 3개 이상이면 구분선이 그어진다.

[[분류:마크다운]] [[분류:문법]]

가온 위키

2025-02-09T12:48:48Z

Admin: 시작

{{틀:가온_위키_주요_서비스}}<br/>

{{틀:가온 위키 소개}}<br/>

{{위키
| 위키 메인색 = #00BCD4
| 글자색 = white
| 위키명 = 가온 위키
| 영문 위키명 = GaonWiki
| 위키 로고 = gaonwiki_kr.png
| 언어 = 한국어
| 설립일 = {{날짜/출력|2015-12-30}}
| 운영진 = [[사용자:Admin]]
| 위키 엔진 = [[미디어위키]]
| 라이선스 = [[크리에이티브 커먼즈 라이선스#저작자표시-동일조건변경허락|CC BY-SA 4.0]]
| 가입 필요 여부 = 선택
| 현재 상태 = 운영중
| 사이트 = {{공식 홈페이지|https://www.gaonwiki.com/w}}, [https://bbs.gaonwiki.com 가온 위키 커뮤니티]
}}

==개요==
2015년 12월 30일에 시작된 한국의 위키 서비스. '''지금 보고 있는 곳이 바로 가온 위키'''이다. 한국어를 기반으로 하는 위키 중에서는 중형급에 속하는 규모를 자랑하며, 특유의 자유로운 분위기로 인해 꾸준한 성장세를 보이고 있다.

이름의 유래는 '가온'이라는 순우리말에서 따왔다. 가온은 '가운데' 혹은 '중심'이라는 의미로, 모든 지식의 중심이 되겠다는 야심찬 포부를 담고 있다. <ref>실제로 관리자 [[정가온]]의 이름을 따서 지었다는 설도 있다.</ref>

==특징==
===자유로운 문서 작성===
가온 위키의 가장 큰 특징은 최소한의 규정만을 두고 있다는 점이다. 다른 위키들이 엄격한 규정을 두고 있는 것과는 달리, 가온 위키는 문서 작성의 자유도를 최대한 보장한다.

* 출처 표기가 의무가 아니다
** 단, 파일 업로드 시에는 예외적으로 출처를 반드시 표기해야 한다
* 문서 서술 방식이 자유롭다
** 백과사전식 서술을 강제하지 않는다
* 문서 분량에 제한이 없다
** 지나치게 긴 문서는 가독성을 위해 분할을 권장한다

===토론 중심의 운영===
규정보다는 토론을 통한 합의를 중시한다. 이는 위키의 경직화를 막고 융통성 있는 운영을 가능하게 한다.

* 문서 내용에 대한 이견이 있을 경우 토론을 통해 해결
* 불편한 규정은 토론을 통해 개정 가능
* 토론 결과에 따라 규정의 임시 효력 정지도 가능

===기술적 특징===
====위키 엔진====
[[미디어위키]]를 사용하고 있다. 위키피디아와 동일한 엔진을 사용하므로, 문서 편집이 익숙한 사용자들이 많다. 다만 [[나무위키]] 문법과는 [[도움말:위키 문법/문법 차이/나무마크|다른 점]]이 있으므로 약간의 학습이 필요하다.

====로그인 시스템====
회원가입은 선택사항이다. 비회원도 대부분의 문서를 열람하고 편집할 수 있으나, 일부 중요 문서는 회원에게만 편집 권한이 주어진다.

과거에는 위키와 커뮤니티 간 로그인 연동을 지원했으나, 모종의 이유로 현재는 중단된 상태이다.

==논란==
자세한 내용은 [[가온 위키/논란]] 문서를 참고하자.

==발전 계획==
자세한 내용은 [[가온 위키:목표]]를 참고하자.

현재 가온 위키는 다음과 같은 목표를 가지고 있다:
* 서버 안정성 개선
* 편집 인터페이스 개선
* 문서 품질 관리 시스템 도입
* 커뮤니티 활성화
* 대형 위키로의 성장

==문제점==
자세한 내용은 [[가온 위키/문제점]] 문서를 참고하자.

==각주==
<references/>

==관련 항목==
* [[한국의 위키 목록]]
* [[미디어위키 기반 사이트]]
* [[가온 위키 커뮤니티]]
* [[정가온]]


[[분류:가온 위키]]
[[분류:미디어위키 기반 사이트]]
[[분류:2015년 설립된 웹 사이트]]
[[분류:한국의 위키]]

가온 위키:면책 조항

2025-02-09T12:41:16Z

Admin: 문서 개선

== 개요 ==
가온 위키는 집단 지성을 통해 만들어지는 위키 백과사전으로, 누구나 문서 편집에 참여할 수 있는 개방형 플랫폼입니다. 이러한 특성상 콘텐츠의 정확성과 법적 책임 소재에 대해 명확한 기준이 필요합니다.

== 저작권, 라이선스 ==
=== CCL 라이선스 ===
가온 위키는 [[크리에이티브 커먼즈 라이선스]] (Creative Commons License, [[CCL]])의 '''CC-BY-SA 4.0''' 버전을 채택하고 있습니다. 이는 다음과 같은 권한과 제약을 포함합니다:

* '''저작자표시(BY)''' - 원저작자의 이름, 출처 등 저작자 정보를 반드시 표시해야 합니다.
* '''동일조건변경허락(SA)''' - 저작물을 변경하거나 2차 저작물을 작성할 경우 원저작물과 동일한 라이선스를 적용해야 합니다.

===책임의 한계===
{| class="wikitable" style="margin:1em auto; width:95%;"
|+ 저작권 관련 책임 소재
|-
! 항목 !! 책임 소재
|-
| 저작권 침해 || 개별 편집자
|-
| 콘텐츠 정확성 || 개별 편집자
|-
| 2차 가공물 || 가공자
|}

== 재판권 ==
=== 법적 분쟁 시 대응 ===
가온 위키는 기본적으로 플랫폼 제공자로서의 역할만을 수행하며, 다음과 같은 원칙을 따릅니다:

* 개별 문서의 내용에 대한 법적 책임은 작성자에게 있습니다.
* 사법기관의 공식 요청이 있을 경우에만 제한적으로 협조합니다.
* IP 주소 등 기술적 정보는 법원 명령이 있을 때만 제공됩니다.

== 전문가의 견해가 아닙니다 ==
=== 전문 분야별 주의사항 ===
==== 의료 정보 ====
* 본 위키의 의료 관련 정보는 참고용으로만 사용해야 합니다.
* 실제 진단이나 치료는 반드시 전문의와 상담하십시오.
* 응급 상황 시 즉시 119에 연락하시기 바랍니다.

==== 법률 정보 ====
* 법률 관련 내용은 일반적인 정보 제공 목적입니다.
* 구체적인 법률 문제는 변호사와 상담하십시오.
* 각 사례별로 적용되는 법률이 다를 수 있습니다.

==== 재무/투자 정보 ====
* 투자는 본인 책임 하에 이루어져야 합니다.
* 금융 상품 가입 전 반드시 전문가와 상담하십시오.
* 과거의 수익이 미래 수익을 보장하지 않습니다.

=== 정보의 검증 ===
* 문서 내용은 다수의 편집자가 작성한 것으로, 부정확할 수 있습니다.
* 중요한 판단에는 반드시 1차 자료를 확인하시기 바랍니다.
* 최신 업데이트 여부를 확인하는 것이 좋습니다.

[[분류:가온 위키]]
[[분류:법적 고지]]
[[분류:이용자 안내]]

미디어위키:Liberty-Navbar

2024-07-12T03:17:59Z

Admin: 스킨 업데이트에 따라 구조 변경

가온 위키:기능 구현 불가-누가 해결책을 알려주세요!/리버티 스킨

2024-07-12T03:15:37Z

Admin: 미디어위키:Liberty-Navbar의 형식과 맞지 않게 Navbar가 출력되는 문제 추가

==이 문서는==
다양한 오류/버그/개선사항들 중에서 리버티 스킨에서 일어나는 문제 중 해결한 경우를 해결책과 함께 보실 수 있습니다. 각 문단에는 문제점과 해결방안에 대해 적혀져 있으므로, 해당하는 파일을 수정하시길 바랍니다.

이 문서에서 사용하는 변경사항은 가온 위키/가온 위키 베타 모두 적용되어 있습니다. 버전에 따라 줄수가 다르거나 없을 수도 있다는 점 참고바랍니다.

최신 버전에서는 해결된 경우, 확인된 커밋명을 입력해 주시기 바랍니다.

==최근바뀜에서 문서명에 / 가 포함되어 있으면, 오류 뜨는 경우==
리버티 스킨 최신 버전([https://github.com/librewiki/liberty-skin/commit/178653922dab071a26caac48fc3a590a0aa5a272 178653922dab071a26caac48fc3a590a0aa5a272])에서는 정상 작동합니다.

같은 스킨을 쓰는 [[리브레 위키]]에서는 잘 되던데... 서버 설정 오류인가? [https://quiple.mcsv.io/w/퀴플위키 퀴플위키]에서 해결책을 찾았다. 감사합니다. 퀴플위키!<ref>최신 버전 기준이다.</ref>
===수정 전===
* 리버티 스킨/js 폴더에 있는 live-recent.js를 수정한다.

<syntaxhighlight lang="JavaScript" highlight="5" start='55' line>
var recentChanges, html, time, line, text;
recentChanges = data.query.recentchanges;
html = recentChanges.map( function ( item ) {
time = new Date( item.timestamp );
line = '<li><a class="recent-item" href = "' + ( mw.config.get( 'wgArticlePath' ) ).replace( '$1', encodeURIComponent( item.title ) ) + '" title="' + item.title + '">[' + timeFormat( time ) + '] ';
text = '';
if ( item.type === 'new' ) {
text += '[New]';
}
text += item.title;
if ( text.length > 13 ) {
text = text.substr( 0, 13 );
text += '...';
}
</syntaxhighlight><br/>

===수정 후===
<syntaxhighlight lang="JavaScript" highlight="5" start='55' line>
var recentChanges, html, time, line, text;
recentChanges = data.query.recentchanges;
html = recentChanges.map( function ( item ) {
time = new Date( item.timestamp );
line = '<li><a class="recent-item" href = "' + ( mw.config.get( 'wgArticlePath' ) ).replace( '$1', encodeURI( item.title ) ) + '" title="' + item.title + '">[' + timeFormat( time ) + '] ';
text = '';
if ( item.type === 'new' ) {
text += '[New]';
}
text += item.title;
if ( text.length > 13 ) {
8 = text.substr( 0, 13 );
text += '...';
}
</syntaxhighlight><br/>
# 59번째 줄의 encodeURIComponent( item.title ) )에서 encodeURIComponent를 encodeURI로 변경

==로그인시 '이러한 명령이 없습니다' 라는 오류 뜸==
# 로그인시, 특히 [[가온 위키:대문]] 문서가 아닌 다른 문서를 보다가 상단의 로그인 아이콘을 눌러 로그인 시도시 심심치 않게 '이러한 명령이 없습니다'라는 오류가 발생한다.
# 오류 내용을 자세히 보면, 'URL에 지정한 명령이 올바르지 않습니다. URL을 잘못 입력했거나, 올바르지 않은 링크를 따라갔을 수 있습니다. 가온 위키에 사용하는 소프트웨어의 버그일 수도 있습니다.' 라고 나타나 있다.
# 오류 해결은 [https://issue.librewiki.net/T515 리브레 위키 이슈 트래커]에서 찾았다.

===수정 전===
* 리버티 스킨에 있는 '''LibertyTemplate.php''' 파일을 수정한다.

<syntaxhighlight lang="PHP" highlight="4-5" start='343' line>
<div class="modal-body">
<div id="modal-login-alert" class="alert alert-hidden alert-danger" role="alert">
</div>
<form id="modal-loginform" name="userlogin" class="modal-loginform"
method="post">
<input class="loginText form-control" id="wpName1" tabindex="1"
placeholder="<?php echo $skin->msg( 'userlogin-yourname-ph' )->plain() ?>" value="" name="lgname">
</syntaxhighlight><br/>

===수정 후===
<syntaxhighlight lang="PHP" highlight="4-5" start='343' line>
<div class="modal-body">
<div id="modal-login-alert" class="alert alert-hidden alert-danger" role="alert">
</div>
<form id="modal-loginform" name="userlogin" class="modal-loginform"
method="post" onsubmit="return LoginManage();">
<input class="loginText form-control" id="wpName1" tabindex="1"
placeholder="<?php echo $skin->msg( 'userlogin-yourname-ph' )->plain() ?>" value="" name="lgname">
</syntaxhighlight><br/>

==어두운 모드 사용시 표가 있는 부분의 배경색이 검정색이 되지 않는 버그==
[[사용자:hunhee|hunhee님]]이 알려주셨어요!

리버티 스킨 루트 폴더에 있는 '''"SkinLiberty.php"''' 파일을 열어서 수정합니다.
===수정 전===
<syntaxhighlight lang="PHP" highlight="1-2" start='138' line>
$LibertyDarkCss = "body, .Liberty, .dropdown-menu, .dropdown-item, .Liberty .nav-wrapper .navbar .form-inline .btn, .Liberty .content-wrapper .liberty-sidebar .liberty-right-fixed .live-recent .live-recent-header .nav .nav-item .nav-link.active, .Liberty .content-wrapper .liberty-content .liberty-content-main table.wikitable tr > th, .Liberty .content-wrapper .liberty-content .liberty-content-main table.wikitable tr > td, table.mw_metadata th, .Liberty .content-wrapper .liberty-content .liberty-content-main table.infobox th, #preferences fieldset:not(.prefsection), #preferences div.mw-prefs-buttons, .navbox, .navbox-subgroup, .navbox > tbody > tr:nth-child(even) > .navbox-list{
background-color:#000;
color: #DDD;
}
</syntaxhighlight>

===수정 후===
<syntaxhighlight lang="PHP" highlight="1-2" start='138' line>
$LibertyDarkCss = "body, .Liberty, .dropdown-menu, .dropdown-item, .Liberty .nav-wrapper .navbar .form-inline .btn, .Liberty .content-wrapper .liberty-sidebar .liberty-right-fixed .live-recent .live-recent-header .nav .nav-item .nav-link.active, .Liberty .content-wrapper .liberty-content .liberty-content-main table.wikitable tr > th, .Liberty .content-wrapper .liberty-content .liberty-content-main table.wikitable tr > td, table.mw_metadata th, .Liberty .content-wrapper .liberty-content .liberty-content-main table.infobox th, #preferences fieldset:not(.prefsection), #preferences div.mw-prefs-buttons, .navbox, .navbox-subgroup, .navbox > tbody > tr:nth-child(even) > .navbox-list, table.wikitable{
background-color:#000!important;
color: #DDD;
}
</syntaxhighlight>

* 138번째 줄의 '''"<nowiki>{</nowiki>"''' 바로 앞에 '''"<nowiki>, table.wikitable</nowiki>"'''을 붙히고, 139번째 줄에서 '''"#000"''' 다음에 '''"<nowiki>!important</nowiki>"'''을 붙힌다.

==모바일에서 가로로 긴 표가 화면을 넘어갈때 좌우 스크롤 되도록==
모바일에서 위키를 볼때 거의 대다수가 세로로 보는데, 가끔 보면 표가 가로로 긴 경우들이 있어요. 스킨 기본값은 짤린 상태로 표시되는데요. 좌우 스크롤을 할 수 있도록 개선해 보아요.

수정할 파일은 스킨 폴더 → css 폴더 안에 있는 wiki-table.css 파일이에요.

===수정 전===
<syntaxhighlight lang="CSS" start='52' line>
.Liberty .content-wrapper .liberty-content .liberty-content-main table.wikitable {
width: auto;
}
</syntaxhighlight>

===수정 후===
<syntaxhighlight lang="CSS" highlight="3-4" start='52' line>
.Liberty .content-wrapper .liberty-content .liberty-content-main table.wikitable {
width: auto;
display: block;
overflow-x: auto;
}
</syntaxhighlight>

'''"<nowiki>width: auto;"</nowiki>''' 밑에 '''"<nowiki>display: block;"</nowiki>'''과 '''"<nowiki>overflow-x: auto;"</nowiki>'''을 추가합니다.

==광고 추가하기==
[https://gitlab.com/librewiki/Liberty-MW-Skin 리버티 스킨 저장소]에 광고를 다는 방법에 대해 설명되어 있지만, 매우 불친절하게 알려져 있어 추가하기가 쉽지 않습니다. 아래는 저장소에 적혀져 있는 광고 추가 방법의 예제입니다.

<syntaxhighlight lang="PHP" highlight="1">
array( 'client' => '(Google Adsense에서 제공한 값)', 'header' => '1234567890', 'right' => '0987654321', 'belowarticle' => 1313135452 )
</syntaxhighlight>

<code>'client'</code> 부분은 "Google Adsense에서 제공한 값"이라고 적혀져 있기 때문에 어렵지 않게 입력할 수 있지만, 이후의 <code>'header'</code>, <code>'right'</code>, <code>'belowarticle'</code> 부분은 임의의 숫자로 적혀져 있어 어떤것인지 알기 매우 어렵습니다.

리브레 위키측에 [https://bbs.librewiki.net/wiki/202181 문의]를 해도 이슈트래커에 확인하라고 하고, 이슈트래커에 문의하니 README.md 내용을 보라고 하니...

<code>'header'</code>, <code>'right'</code>, <code>'belowarticle'</code> 부분은 <code>data-ad-slot</code> 부분을 입력하면 됩니다.

== 로고 짤림 문제 해결 ==
<code>$wgLibertyNavBarLogoImage</code>로 로고 파일의 위치를 지정할 수 있게 되었는데, 로고의 크기가 원본 이미지 파일(리브레 위키 로고)와 동일하지 않고 크면 짤리는 문제가 있다. 이를 해결했다.

=== 수정 전 ===
<code>SkinLiberty.php</code> 파일을 수정한다.
<syntaxhighlight lang='php' line start='147' highlight='4'>
if ( isset( $wgLibertyNavBarLogoImage ) ) {
$out->addInlineStyle(
".Liberty .nav-wrapper .navbar .navbar-brand {
background: transparent url($wgLibertyNavBarLogoImage) no-repeat scroll left center/auto 1.9rem;
}"
);
}
</syntaxhighlight>

=== 수정 후 ===
151번째 줄에 <code>background-size: contain;</code>를 입력한다.

<syntaxhighlight lang='php' line start='147' highlight='4-5'>
if ( isset( $wgLibertyNavBarLogoImage ) ) {
$out->addInlineStyle(
".Liberty .nav-wrapper .navbar .navbar-brand {
background: transparent url($wgLibertyNavBarLogoImage) no-repeat scroll left center/auto 1.9rem;
background-size: contain;
}"
);
}
</syntaxhighlight>

그러면 크기가 클 경우, 이미지를 자동으로 맞춰준다.

== 분류 표기가 목록형으로 나타나는 오류 ==
{{접기
| 미디어위키 1.39 버전에서 분류 표기가 목록형으로 나타나는 오류 (우측의 펼치기를 눌러 자세히 확인하기)
|<hr>본 문서는 해결 방법을 적어놓은 문서입니다. 질문사항은 [https://bbs.gaonwiki.com/free 위키 커뮤니티(권장)]나 본 문서의 [[가온 위키토론:기능 구현 불가-누가 해결책을 알려주세요!/리버티 스킨|토론 문서]]를 통해 질문해 주시면 감사하겠습니다. 아래의 내용은 글 원본입니다.<br>

# 최초 발견된 게시글은 [https://bbs.librewiki.net/wiki/223909 리브레 위키 위키방의 한 게시글]로 추정된다. 이것도 리브레 스킨을 쓰는 다른 위키에서는 잘 되는건데...
# 위키 본문에서 '[[별표]]'(*)를 사용해서 목록을 만드는 것 처럼, 분류가 목록형이 된다. "뭐 분류가 한 두개 정도만 있으면 괜찮겠지" 라고 생각하겠지만, 분류 하나마다 한 줄이라 [https://ko.wikipedia.org/wiki/%EB%B8%8C%EC%9D%B4_%ED%8F%AC_%EB%B2%A4%EB%8D%B0%ED%83%80_(%EC%98%81%ED%99%94) 이런 문서]처럼 분류가 아주 많이 붙어있는 문서라면 당연히 가독성이 수직낙하할거다!
# 스킨이 지원하는 [[미디어위키]] 버전이 맞지 않거나, [[php]] 버전 8 이상에서 나타나는 문제라고 들어 이 둘의 버전을 맞춰봤지만, 동일한 증상이 나온다. 위의 질문자분도 XAMPP에서 설치했다고 했는데 그냥 환경이 [[XAMPP]]라서 그러는걸까?
<hr>
}}<br>

[[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!#미디어위키 1.39 버전 업그레이드 이후 분류값 앞에 점이 표시되고 세로로 정렬되는 문제]] 문단을 확인하면 해결이 가능합니다.

== Navbar 순서 오류 ==
[[미디어위키:Liberty-Navbar]] 형식일 때, 각 드롭다운 메뉴의 마지막 항목이 다음 드롭다운 타이틀로 적용되는 문제가 있습니다. [https://github.com/librewiki/liberty-skin/issues/31 관련 깃허브 이슈]

[[파일:리버티 스킨 navbar 순서 오류.png]]

=== 수정 전 ===
'''주의! 정상 작동하던 커밋을 기준으로 수정한 것이므로, 이후 커밋에서 수정된 사항이 반영되어 있지 않을 수 있습니다. 임시방편으로 사용하고 정식 수정버전이 나오면 바로 정식버전을 사용하시기 바랍니다!'''

<code>LibertyTemplate.php</code> 파일을 수정합니다. 내용이 너무 많아서 일부 항목을 수정합니다.
<syntaxhighlight lang='php' line start='878'>
protected function parseNavbar() {
global $wgArticlePath;

$headings = [];
$currentHeading = null;
$skin = $this->getSkin();
$userName = $skin->getUser()->getName();
$userLang = $skin->getLanguage()->mCode;
$globalData = ContentHandler::getContentText( $this->getContentOfTitle(
Title::newFromText( 'Liberty-Navbar', NS_MEDIAWIKI )
) );
...
</syntaxhighlight>

=== 수정 후 ===
[https://github.com/librewiki/liberty-skin/issues/31 깃허브 이슈]에서 <code>protected function parseNavbar()</code> 부분을 수정합니다. 너무 길어(400줄 이상) 생략합니다.

==분기==
{{분기|가온 위키:기능 구현 불가-누가 해결책을 알려주세요!|6010||가온 위키}}

==각주==

파일:리버티 스킨 navbar 순서 오류.png

2024-07-12T03:11:03Z

Admin: Admin님이 파일:12.png 문서를 넘겨주기를 만들지 않고 파일:리버티 스킨 navbar 순서 오류.png 문서로 이동했습니다: 임시 파일명이 적용되던 문제 수정

== 파일 설명 ==
가온 위키 베타에서 발생한 문제, 가온 위키 베타의 라이선스는 CC BY-SA 4.0이므로, 이 파일도 동일한 라이선스를 적용합니다.
== 저작권 ==
{{CC-BY-SA-4.0}}

파일:리버티 스킨 navbar 순서 오류.png

2024-07-12T03:10:34Z

Admin: 가온 위키 베타에서 발생한 문제, 가온 위키 베타의 라이선스는 CC BY-SA 4.0이므로, 이 파일도 동일한 라이선스를 적용합니다.

가온 위키:기능 구현 불가-누가 해결책을 알려주세요!

2024-06-12T03:50:58Z

Admin: Kartographer 확장기능 내용 추가

==이 문서는...==
답답한 우리의 [[사용자:Admin|가온 위키 관리자]]가 구현하지 못해, 착한 유저가 해결책을 제시한 경우, 감사의 표시로 이곳과 [[가온 위키 커뮤니티]]에 표시하는 곳입니다.<br/>

==구현 못한 부분==
* 아직까지 없습니다.

==해결됨==

===리버티 스킨 관련 문제===
리버티 스킨과 관련된 문제는 [[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!/리버티 스킨]] 문서를 참고하자.

===영상 가져오기(Embed) 관련 문제===
외부 서비스들 중에서 가져오지 못하는 것들은 [[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!/영상 가져오기]] 문서를 참고하자!

===이미지 관련 문제===
====이미지 크기 설정시 파일 링크만 뜨는 현상====
<nowiki>[[파일:updates.png|100px]]</nowiki> 이렇게 하면 일반 문서처럼 링크로 뜬다. 서버 이전 전에는 이러지 않았는데...

[https://m.mediawiki.org/w/index.php?title=Topic:Rnjccxoqss9wfedy&topic_showPostId=rnq05rzcc6o7z4hc#flow-post-rnq05rzcc6o7z4hc 미디어위키 헬프 데스크]에서 찾았다.

=====수정 전=====
[[미디어위키]]의 루트 폴더에 있는 [[미디어위키/LocalSettings.php|LocalSettings.php]]를 수정한다.

=====수정 후=====
[[LocalSettings.php]]의 하단 부분에 추가하자.
<syntaxhighlight lang='php'>
$wgGenerateThumbnailOnParse = true;
</syntaxhighlight>

그리고 [[미디어위키]] 버전이 1.30 이상인 경우, 썸네일을 재생성하자. [[미디어위키]]의 루트 폴더에서 '''maintenance''' 폴더로 이동한 뒤, 아래의 명령어를 입력하자.

<syntaxhighlight lang='console'>
root@gaon:/var/www/html/w/maintenance# php rebuildImages.php
</syntaxhighlight>

=====하고 싶은말=====
이 오류는 [[미디어위키]] 1.27 버전에서는 없던 오류이므로 1.30 이상 버전의 오류같다. 물론 썸네일은 [[Imagemagick]]가 미리 설치 및 [[미디어위키]]에서 미리 설정 되어 있어야 한다.

====SVG 파일 업로드시 썸네일의 흑백화====
SVG 파일을 업로드하면 원래 가지고 있던 색상값은 표시되지 않고 흑백으로만 표시가 된다. 이는 SVG를 png로 변환하는 프로그램인 ImageMagick의 특정 버전에서 나타난 오류이다. [https://bbs.gaonwiki.com/free/3877 zlzleking님]이 보고해 주셨다.

=====수정 전=====
먼저 Inkscape를 설치한다. 우분투 기준으로 아래의 명령어를 입력하면 된다.
<syntaxhighlight lang='console'>
root@gaon:/# apt update
root@gaon:/# apt install inkscape
</syntaxhighlight>

이후 [[미디어위키]]의 루트 폴더에 있는 [[미디어위키/LocalSettings.php|LocalSettings.php]]를 수정한다.

<syntaxhighlight lang='php'>
$wgSVGConverter = 'ImageMagick';
</syntaxhighlight>

=====수정 후=====
[[LocalSettings.php]]의 하단 부분에 추가하자. Inkscape의 경로는 자신의 환경에 맞춰 수정하자.
<syntaxhighlight lang='php'>
$wgSVGConverterPath = '/usr/bin/inkscape';
$wgSVGConverters = [
'Inkscape' => '/usr/bin/inkscape -w $width -z -w $width -f $input -e $output',
];
$wgSVGConverter = 'Inkscape';

#$wgSVGConverter = 'ImageMagick';
</syntaxhighlight>

여기서
<syntaxhighlight lang='php'>
$wgSVGConverter = 'ImageMagick';
</syntaxhighlight>
부분은 반드시 주석처리 한다.

그리고 [[미디어위키]] 버전이 1.30 이상인 경우, 썸네일을 재생성하자. [[미디어위키]]의 루트 폴더에서 '''maintenance''' 폴더로 이동한 뒤, 아래의 명령어를 입력하자.

<syntaxhighlight lang='console'>
root@gaon:/var/www/html/w/maintenance# php rebuildImages.php
</syntaxhighlight>

===신택스 강조(Syntax Highlight) 사용시 사용된 문서가 '''구문 강조에 오류가 있는 문서'''로 분류되는 현상===
미디어위키 1.33.1 버전에 있는 [[미디어위키/확장기능/SyntaxHighlight|SyntaxHighlight 확장기능]]을 사용하는 경우, "구문 강조에 오류가 있는 문서"로 자동 분류된다.

미디어위키 코어에 포함되어 있는 버전만 파이썬 전역 환경변수 처리를 요구한다.

====구버전 사용====
1.32.x 버전의 구버전을 사용하는 방법이다.
웹호스팅과 같이 서버를 직접 조작하지 못하는 경우에 사용하면 된다.

[https://www.mediawiki.org/wiki/Special:ExtensionDistributor/SyntaxHighlight_GeSHi SyntaxHighlight 다운로드 페이지]로 이동 후, 미디어위키 버전을 1.32 버전으로 설정 후, 기존에 있던 확장기능 삭제 후 새로 받은 버전으로 업로드 한다.

====확장기능 페이지서 1.33버전으로 다운로드====
이상하게 1.33 버전으로 다운로드 받아도 작동한다. 아마도 코어 파일에 포함되어 있는 버전만 파이썬 전역 환경변수 처리해야 하는 것 같다.

이후 미디어위키 1.34 코어에 포함된 버전은 해당 문제가 발생하지 않는다. 1.33.1에 포함된 버전만 문제인 것 같다.

====파이썬3 설치====
1.35.1 기준, 서버에 파이썬3를 설치하면 해당 문제는 발생하지 않는다.

설치방법은 쉘에

<syntaxhighlight lang='console'>
root@gaon:/# apt update && apt -y install python3
</syntaxhighlight>

이라고 입력한다. 설치가 되었는지 확인하려면,
<syntaxhighlight lang='console'>
root@gaon:/# python3 --version
Python 3.8.5
</syntaxhighlight>
이라고 입력한다. 이때 버전은 위의 버전과 다를 수 있다.

===TitleKey 확장기능 설치===
대소문자 구분 없이 문서를 검색 할 수 있는 [[미디어위키/확장기능/TitleKey|TitleKey]] 설정 중, <code>php extensions/TitleKey/maintenance/rebuildTitleKeys.php</code> 명령어를 입력할 때, 경로를 찾지 못하는 문제가 있다.

이 문제는 환경변수 <code><nowiki>$IP</nowiki></code>가 경로를 제대로 반환하지 않아 생기는 문제이다.

여기서는 환경변수 <code><nowiki>$IP</nowiki></code>를 수정하지 않고, 9번째 줄을 절대경로로 바꾸어 사용했다. 사용 환경에 맞추어 수정하길 바란다.

====수정 전====
<syntaxhighlight lang='php' start='5' highlight='5'>
$IP = getenv( 'MW_INSTALL_PATH' );
if ( $IP === false ) {
$IP = __DIR__ . '/../..';
}
require_once "$IP/maintenance/Maintenance.php";

// In case we want to do offline initialization...
if ( !class_exists( 'TitleKey' ) ) {
require __DIR__ . '/../includes/TitleKey.php';
}
</syntaxhighlight>

====수정 후====
<syntaxhighlight lang='php' start='5' highlight='5'>
$IP = getenv( 'MW_INSTALL_PATH' );
if ( $IP === false ) {
$IP = __DIR__ . '/../..';
}
require_once "/var/www/html/w/maintenance/Maintenance.php";

// In case we want to do offline initialization...
if ( !class_exists( 'TitleKey' ) ) {
require __DIR__ . '/../includes/TitleKey.php';
}
</syntaxhighlight>

또는 상대경로로 지정해도 된다. 이 경우에는 미디어위키 설치 경로에 구애받지 않는다는 장점이 있다.

<syntaxhighlight lang='php' start='5' highlight='5'>
$IP = getenv( 'MW_INSTALL_PATH' );
if ( $IP === false ) {
$IP = __DIR__ . '/../..';
}
require_once "../../../maintenance/Maintenance.php";

// In case we want to do offline initialization...
if ( !class_exists( 'TitleKey' ) ) {
require __DIR__ . '/../includes/TitleKey.php';
}
</syntaxhighlight>

==비주얼 에디터 설치==
비주얼 에디터를 설치하고, 사용할 수 있다. 다만 짧은 주소 설정시 오류가 발생할 수 있으므로 본 코드를 사용하자.

===짧은 주소 설정(선택, 권장)===
짧은 주소를 설정하자. .htaccess를 사용하므로 아파치 이용자만 할 수 있다.(짧은 주소 자체는 nginx도 할 수 있지만, 서술하지 않음).

먼저 [[미디어위키/LocalSettings.php|LocalSettings.php]]가 있는 루트 폴더로 이동하여 .htaccess를 열자. 없으면 생성하자.

이후 아래와 같이 입력한다.

<syntaxhighlight>
RewriteEngine On
RewriteBase /w/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /w/index.php [L]

RewriteCond %{HTTP_USER_AGENT} !^(VisualEditor)
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
RewriteRule ^(.*)$ %{DOCUMENT_ROOT}/index.php [L]

RewriteCond %{HTTP_USER_AGENT} !^(VisualEditor)
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
RewriteRule ^/?images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/thumb.php?f=$1&width=$2 [L,QSA,B]

RewriteCond %{HTTP_USER_AGENT} !^(VisualEditor)
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
RewriteRule ^/?images/thumb/archive/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/thumb.php?f=$1&width=$2&archived=1 [L,QSA,B]
</syntaxhighlight>

여기서 2번째 줄과 6번째 줄에 있는 <code>/w/</code> 부분에 원하는 줄임(<nowiki>https://example.com/w/문서명</nowiki>) 단어를 입력한다.

[https://wnw1005.tistory.com/168 출처 : 씨실과 날실님 티스토리 블로그], [https://www.mediawiki.org/wiki/Topic:W2ahzg3yi27mvp9y 미디어위키 토론 중 Rogerhc님의 답변]

이후 LocalSettings.php 하단에 다음과 같이 입력한다.
<syntaxhighlight lang='php'>
$wgScriptExtension = ".php";
$wgArticlePath = "{$wgScriptPath}/$1";
$wgUsePathInfo = true;
</syntaxhighlight>

===비주얼 에디터 설치===
1.37버전은 이미 extensions 폴더에 있다. 코어에 포함되어 있으나, 삭제한 사람은 [https://www.mediawiki.org/wiki/Extension:VisualEditor 미디어위키 비주얼 에디터 페이지]에서 자신의 버전에 맞게 다운로드 받은 뒤 extensions 폴더 안에 넣는다.

이후 LocalSettings.php 하단에 다음과 같이 입력한다.
<syntaxhighlight lang='php'>
wfLoadExtension( 'VisualEditor' );
</syntaxhighlight>

이러면 끝이다.

== 미디어위키 1.39 버전 업그레이드 이후 분류값 앞에 점이 표시되고 세로로 정렬되는 문제 ==
미디어위키 1.39 rc버전에서는 이런 문제가 없었지만, 1.39 정식버전에서는 분류값 앞에 점이 표시되고, 세로로 정렬되는 문제가 있다. 또한 분류값이 '''분류:'''밑에 줄에 표시되는 문제가 있다.
[[파일:미디어위키1_39_분류_문제.png]]

이는 [[미디어위키:Common.css]] 문서를 수정하면 된다.

=== 수정 전 ===
<syntaxhighlight lang='css'>
/* 이 CSS 설정은 모든 스킨에 적용됩니다 */
.mw-highlight pre {
font-size: 90%;
}
</syntaxhighlight>

=== 수정 후 ===
<syntaxhighlight lang='css'>
/* 이 CSS 설정은 모든 스킨에 적용됩니다 */
.mw-highlight pre {
font-size: 90%;
}

/* 1.39 버전에서 분류 표시가 li로 표시돠는 문제 해결 */
#mw-normal-catlinks > ul {
list-style: none;
}

#mw-normal-catlinks > ul > li {
float: left;
margin-right: 15px;
}

/* 분류: 밑부분에 분류값이 표시되는 문제 해결 */
#mw-normal-catlinks {
display: flex;
align-items: center;
}
</syntaxhighlight>

=== 지도 확장기능 Kartographer 오류 ===
예전에는 [https://www.mediawiki.org/wiki/Extension:Kartographer Kartographer] 확장기능에 별도의 타일 서버 URL 설정을 하지 않더라도 지도가 출력되었지만, 현재는 설정하지 않으면 `Uncaught Error: wgKartographerMapServer must be configured.`이라고 뜹니다.

==== 수정 전 ====
`LocalSettings.php`에서 다음 항목을 수정합니다.

<syntaxhighlight lang='php'>
wfLoadExtension( 'Kartographer' );
</syntaxhighlight>

==== 수정 후 ====
<syntaxhighlight lang='php'>
wfLoadExtension( 'Kartographer' );

# 타일 서버 설정
$wgKartographerMapServer = 'https://tile.openstreetmap.org';
$wgKartographerStyles = ["osm"];
$wgKartographerDfltStyle = "";

# 아래의 세부 설정은 선택사항
$wgKartographerSrcsetScales = [];
$wgKartographerUseMarkerStyle = false;
$wgKartographerWikivoyageMode = false;
$wgKartographerStaticMapframe = false;
$wgKartographerStaticFullWidth = 1024;
$wgKartographerUsePageLanguage = true;
$wgKartographerFallbackZoom = 13;
$wgKartographerSimpleStyleMarkers = true;
</syntaxhighlight>

==구현한 기능==
=== 인디케이터 표시 ===
[https://github.com/merlinwarage/simple-scroll-progress simple-scroll-progress]를 이용하여 스크롤한 범위를 표시하는 기능입니다.

[[파일:리버티 스킨-스크롤 범위.gif]]<ref>초기의 타 라이브러리를 사용한 모습. 현재 버전은 본 위키에 적용되어 있다.</ref>

혹시 사용하고 싶다면, [https://github.com/gaon12/Liberty Liberty 깃허브 저장소]를 다운로드 받아 사용하면 된다. 라이브러리는 외부에서 불러오니 참고하자.

=== 클라우드플레어 원본 IP 주소 표시 ===
클라우드플레어 사용 시, 비로그인 유저가 문서를 편집하는 경우, ip주소가 클라우드플레어의 ip로 기록됩니다. 이를 수정해주는 확장기능을 개발하여 배포합니다.

{{깃허브/저장소|gaon12|mw_CloudflareRealIP}} 확장기능을 설치하면, 원본 IP 주소가 표시됩니다.

==== 설치 ====
# 먼저 GitHub 저장소에서 확장기능을 다운로드하세요.
# 다운로드 받은 확장기능을 미디어위키의 "extensions" 폴더에 업로드합니다.
# 미디어위키의 "LocalSettings.php" 파일을 찾아 아래 코드를 추가하세요

<br>
<syntaxhighlight lang='php'>
wfLoadExtension( 'CloudflareRealIP' );
</syntaxhighlight>

==== 사용법 ====
이 확장기능을 설치하고 나면 아무런 추가 설정 없이 자동으로 작동합니다. CloudflareRealIP 확장기능은 미디어위키에서 로그인하지 않고 편집할 때 Cloudflare의 IP 주소 대신 원래 사용자의 IP 주소를 저장합니다.

==== 참고 사항 ====
이 확장기능은 미디어위키 1.25 이상과 호환됩니다. 또한 Cloudflare 서비스를 사용하는 경우에만 필요하며, Cloudflare를 사용하지 않거나 단순히 DNS만 사용하는 경우 설치할 필요가 없습니다.

==== 원리 ====
Cloudflare Real IP 확장 기능의 작동 원리는 다음과 같습니다:

# 사용자가 미디어위키에서 로그인하지 않고 편집을 진행합니다.
# Cloudflare는 사용자의 원래 IP 주소를 "CF-Connecting-IP"라는 HTTP 헤더를 통해 전달합니다.
# 미디어위키에서는 로그인하지 않은 사용자의 IP 주소를 기록하려 할 때 UserGetIP 이벤트가 발생합니다.
# Cloudflare Real IP 확장 기능은 이 이벤트를 통해 사용자의 IP 주소를 가져옵니다.
# 확장 기능은 $_SERVER['HTTP_CF_CONNECTING_IP'] 변수를 확인하여 Cloudflare가 전달한 원래 사용자의 IP 주소가 있는지 확인합니다.
# 원래 사용자의 IP 주소가 있다면, 확장 기능은 이 IP 주소로 미디어위키에 저장되는 IP 주소를 변경합니다.
# 결과적으로, 미디어위키에서 로그인하지 않은 사용자의 편집 기록에 원래 사용자의 IP 주소가 저장됩니다.

이 확장 기능을 사용하면 Cloudflare를 사용하는 경우에도 미디어위키에서 로그인하지 않은 사용자의 원래 IP 주소를 정확하게 기록할 수 있습니다. 이로 인해 IP 주소를 기반으로 한 사용자 관리 및 안전 조치가 훨씬 간편해집니다.

==== 라이선스 ====
[[MIT 라이선스]]로 배포됩니다.

=== 단축 URL 생성 ===
긴 문서의 URL, 특히 문서명이 한글로 이루어져 있는 경우, URL이 길어져 공유할 때 불편합니다. 그래서 단축 URL을 생성하고, 복사할 수 있는 기능을 추가했습니다.

==== 사용 방법 ====
문서 최하단에 CCL 표기 부분과 '''개인정보처리방침 가온 위키 소개 면책 조항''' 링크 부분 사이에 '''• 현재 페이지 URL 줄이기''' 메뉴를 누르면, 팝업창이 뜨면서 현재 문서의 단축된 URL이 생성이 됩니다.

==== 원리 ====
[[미디어위키]]에는 문서를 편집할 때마다, 문서의 역사에 고유한 번호를 부여합니다. 이 번호는 <code>oldid</code>로, 1부터 편집할 때마다 1씩 증가합니다. 자세한 내용은 [[미디어위키/oldid]] 문서를 참고하세요!

<code>oldid</code> 값을 62진법<ref>숫자(0-9) + 알파벳 대문자(A-Z) + 알파벳 소문자(a-z)</ref>으로 변환하여 단축된 URL을 제공합니다. 일반 문서와 혼동이 생기지 않도록, <code>/a/</code> 경로로 제공됩니다.

==== 주의사항 ====
* <code>oldid</code> 값은 문서가 편집되면 새롭게 바뀌므로, 예전에 생성된 URL 값과 현재의 URL 값에는 차이가 있을 수 있습니다. 하지만 둘 다 원래의 문서로 자동으로 이동하므로 걱정하지 않아도 됩니다.
* 특수 문서, 편집 페이지 등 <code>oldid</code> 값이 존재하지 않는 페이지에는 본 메뉴가 생성되지 않습니다.

==각주==

리버티 스킨

2024-05-18T08:33:51Z

Admin: /* 미디어위키 지원 버전 */ 1.39 버전 이상 권장

{{미디어위키/스킨
| 제목 = 리버티 스킨
| 원제목 = Liberty
| 이미지 = [[File:Screenshot-skin-liberty.png]]
| 배경색 = #4188F1
| 글자색 = #FFFFFF
| 개발사 = 리브레 위키 개발팀
| 미디어위키 버전 = 1.27+
| 라이선스 = GPL 3.0
| 적용 사이트 = [https://librewiki.net 리브레 위키], [[가온 위키]]
| 변수 = {{내용 보기|내용 보기|
* $wgLibertyMainColor
* $wgLibertySecondColor
* $wgTwitterAccount
* $wgLibertyOgLogo
* wgLibertyNavBarLogoImage
* $wgNaverVerification
* $wgLibertyAdSetting
* $wgLibertyAdGroup
* $wgLibertyMobileReplaceAd
* $wgLibertyEnableLiveRC
* $wgLibertyMaxRecent
* $wgLibertyLiveRCArticleNamespaces
* $wgLibertyLiveRCTalkNamespaces
}}
| hooks = [[미디어위키/Hooks/GetPreferences|GetPreferences]]
| 기여자 = [https://github.com/librewiki/liberty-skin/graphs/contributors 기여자 목록]
| 사이트 = {{깃허브/저장소|librewiki|liberty-skin}}
}}

==개요==
[[리브레 위키]]에서 사용할 목적으로 개발된 [[미디어위키]] 스킨. 부트스트랩을 사용한 것이 특징이다.

==미디어위키 지원 버전==
1.27버전 이상을 지원하며, 지원하는 버전의 목록과 해당 버전의 브랜치는 다음과 같다.

* 1.27([https://github.com/librewiki/liberty-skin/tree/REL1_27 REL1_27 branch])
* 1.27([https://github.com/librewiki/liberty-skin/tree/REL1_29 REL1_29 branch])
* 1.31([https://github.com/librewiki/liberty-skin/tree/REL1_31 REL1_31_old branch])
* 1.33([https://github.com/librewiki/liberty-skin/tree/REL1_33 REL1_33 branch])
* 1.35([https://github.com/librewiki/liberty-skin/tree/REL1_35 REL1_35 branch])
* <s>1.37+([https://github.com/librewiki/liberty-skin/tree/master master])</s>

미디어위키의 LTS 버전만 지원하는 것을 목표로 하다가, 이제는 일반 버전도 지원한다. 다만 1.13.7 버전 기준 미디어위키 버전 요구사항이 1.39버전 이상으로 되어 있으므로, 1.39버전 이상을 사용하는 것을 권장한다.

==특징==
===반응형 페이지===
PC, 태블릿, 스마트폰 등 화면 크기에 따라 페이지가 반응형으로 보여진다. 이는 반응형 페이지를 지원하지 않는 경우, 모바일을 위해 [[미디어위키/확장기능/MobileFrontend|MobileFrontend]]을 설치 할 필요가 없어지며, 하나의 스킨으로 여러 기기들에게 보여줄 수 있는 장점이 있다.

===사용자 설정 가능===
사용자가 따로 설정 할 수 있는 부분이 있다. 설정 가능한 부분은 다음과 같다.

* 레이아웃 설정
* 색상 설정
* 글꼴 설정

이 설정은 해당 계정에만 설정이 적용되며, 다른 기기 또는 브라우저라도 로그인을 하면, 해당 설정을 불러온다. 또한, 로그인하지 않으면 설정이 불가능하다.

====레이아웃 설정====
* 고정폭 : 문서 영역의 최대 크기를 지정할 수 있다. 기본값은 1200px.
* 고정형 내비게이션 바 해제 : 최상단의 내비게이션 바가 고정되어 있는 것을 해제 할 수 있다. 기본값은 체크 해제.
* 우측 사이드바 제거 : 우측의 '''"최근 바뀜/최근 토론"''' 목록이 있는 사이드바를 제거할 수 있다. 기본값은 체크 해제.

====색상 설정====
* 주 색상 : 사이트에서 주로 사용할 색상. 기본값은 [[미디어위키/LocalSettings.php|LocalSettings.php]]에서 지정한 변수 <code>[[#$wgLibertyMainColor|$wgLibertyMainColor]]</code>의 색상.
* 보조 색상 지정 : 사이트에서 보조로 사용할 색상. 메뉴에 마우스를 올려 놓았을때 나오는 색상. 기본값은 [[미디어위키/LocalSettings.php|LocalSettings.php]]에서 지정한 변수 <code>[[#$wgLibertySecondColor|$wgLibertySecondColor]]</code>의 색상.
* 시스템의 어두운 모드 설정을 무시하시겠습니까? : 시스템 또는 브라우저에서 다크모드가 활성화 되어 있는 경우, 시스템 설정을 따를 것인지, 아니면 강제로 활성화/비활성화 할 것인지 선택할 수 있다. 기본값은 '''"무시하지 않음"'''.

===== $wgLibertyMainColor =====
리버티 스킨에서 사용할 메인 색상값. 메뉴바(navbar) 색상값이기도 하다. 설정하지 않으면 기본값(<code>#4188F1</code>)이 적용된다.

해당 변수를 사용하려면 [[미디어위키/LocalSettings.php|LocalSettings.php]] 파일에 다음과 같이 입력하면 된다.

<syntaxhighlight lang='php'>
#리버티 스킨 메인 색상 설정
$wgLibertyMainColor = '#00BCD4';
</syntaxhighlight>

===== $wgLibertySecondColor =====
리버티 스킨에서 사용할 서브 색상값. 메뉴 위에 마우스를 올리면 나타나 색상값이기도 하다. 설정하지 않으면 기본값(<code>$wgLibertyMainColor의 값에서 1A1415만큼 뺀 값</code>)이 적용된다.

해당 변수를 사용하려면 LocalSettings.php 파일에 다음과 같이 입력하면 된다.

<syntaxhighlight lang='php'>
#리버티 스킨 서브 색상 설정
$wgLibertySecondColor = '#FFA500';
</syntaxhighlight>

====글꼴 설정====
사이트에서 사용할 글꼴을 선택할 수 있다. 사용 가능한 글꼴은 다음과 같다.

* 기타 - 사용할 글꼴의 URL 주소를 입력한다.
* 본고딕
* 본명조
* 스포카 한 산스
* 나눔고딕
* 나눔명조
* 독도
* 개구쟁이
* 한겨레결체
* 청소년체
* 맑은 고딕

맑은 고딕을 제외한 나머지 폰트들은 구글 서버에서 로드된다. 기본값은 '''"기본값"'''

===그라바타 아이콘===
계정별로 프로필 아이콘을 그라바타 아이콘로 생성하여 보여준다.

===최근바뀜/최근토론 목록===
실시간으로 최근바뀜 목록, 최근토론 목록을 확인 할 수 있다.

===애드센스 지원===
애드센스를 추가할 수 있는 변수(parameter)가 있을 정도로 스킨단에서 애드센스를 추가하기 쉽다. 설명을 어렵게 써놔서 그렇지...

==설치 방법==
자신의 미디어위키 버전에 맞게 브랜치를 선택하여 다운로드 한 뒤, skins 폴더에 압축해제한다. 이때 폴더명은 반드시 '''<code>Liberty</code>'''(L이 대문자)여야 한다.

이후, [[미디어위키/LocalSettings.php|LocalSettings.php]]를 수정한다. 수정할 부분은 2군데이다.

<syntaxhighlight lang="PHP" highlight="1, 6">
$wgDefaultSkin = "liberty";

wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Timeless' );
wfLoadSkin( 'Vector' );
wfLoadSkin( 'Liberty' );
</syntaxhighlight>

이때 <code>$wgDefaultSkin</code> 부분에서는 모두 다 소문자로 작성한다. 자세한 내용은 [[미디어위키/LocalSettings.php#스킨|LocalSettings.php#스킨]] 문서를 참고하자.

==변수==
리버티 스킨에서 사용 할 수 있는 변수는 다음과 같다.

{| class="wikitable"
! 이름 !! 설명 !! 예시 값 !! 기본 값
|-
| $wgLibertyMainColor || theme-color 메타 설정 및 사이트 주 색상 설정 || <code>#4188F1</code> || <code>#4188F1</code>
|-
| $wgLibertySecondColor || 사이트 보조 색상 설정 || <code>#2774DC</code> || <code>$wgLibertyMainColor의 값에서 1A1415만큼 뺀 값</code>
|-
| $wgTwitterAccount || 트위터 카드 계정 설정 || <code>librewiki</code> || <code>(없음)</code>
|-
| $wgLibertyOgLogo || 오픈그래프 태그에 사용 될 이미지 설정 || <code>https://librewiki.net/images/6/6a/Libre_favicon.png</code> ||
<code>$wgLogo의 값</code>
|-
| $wgNaverVerification || 네이버 사이트 도구 인증 코드 || <code>(네이버에서 제공된 값) || <code>(없음)</code>
|-
| $wgLibertyAdSetting || 구글 애드센스 설정 || <code>array( 'client' => '(Google Adsense에서 제공한 값)', 'header' => '1234567890', 'right' => '0987654321', 'belowarticle' => 1313135452 )</code> || <code>(없음)</code>
|-
| $wgLibertyAdGroup || 사용자 그룹별 광고 차등화 여부 설정 || <code>differ</code> || <code>null</code>
|-
| $wgLibertyMobileReplaceAd || 모바일 환경일 시 사이드바 광고를 하단으로 옮깁니다. || <code>true</code> || <code>false</code>
|-
| $wgLibertyEnableLiveRC || 사이드바 최근 변경 사용 여부 || <code>true</code> || <code>true</code>
|-
| $wgLibertyMaxRecent || 사이드바 최근 변경에 등장하는 편집의 최대 개수 || <code>10</code> || <code>10</code>
|-
| $wgLibertyLiveRCArticleNamespaces || 사이드바 최근 변경 왼쪽 탭에 보여질 네임스페이스 목록 || <code>[NS_MAIN, NS_PROJECT, NS_TEMPLATE, NS_HELP, NS_CATEGORY]</code> || <code>[NS_MAIN, NS_PROJECT, NS_TEMPLATE, NS_HELP, NS_CATEGORY]</code>
|-
| $wgLibertyLiveRCTalkNamespaces || 사이드바 최근 변경 오른쪽 탭에 보여질 네임스페이스 목록 || <code>[NS_TALK, NS_USER_TALK, NS_PROJECT_TALK, NS_FILE_TALK, NS_MEDIAWIKI_TALK, NS_TEMPLATE_TALK, NS_HELP_TALK, NS_CATEGORY_TALK]</code> || <code>[NS_TALK, NS_USER_TALK, NS_PROJECT_TALK, NS_FILE_TALK, NS_MEDIAWIKI_TALK, NS_TEMPLATE_TALK, NS_HELP_TALK, NS_CATEGORY_TALK]</code>
|}

==메뉴==
3차 메뉴까지 지원한다. 메뉴는 [[미디어위키:Liberty-Navbar]] 문서의 내용을 불러와 표시한다. 메뉴 작성방법은 다음과 같다.

*첫 번째 단계 메뉴:
::<code>* icon=icon | display=display text | title=hover text | link=link | access=shortcut key | class=custom HTML classes | group=required user group | right=required user right</code>
*두 번째 단계 메뉴:
::<code>** icon=icon | display=display text | title=hover text | link=link | access=shortcut key | class=custom HTML classes | group=required user group | right=required user right</code>
*세 번째 단계 메뉴:
::<code>*** icon=icon | display=display text | title=hover text | link=link | access=shortcut key | class=custom HTML classes | group=required user group | right=required user right</code>

==기타==
무거운 스킨이다. 그렇기 때문에 저사양의 서버에서 돌리기에는 약간의 무리가 있다. 또한 비주얼 에디터를 지원하지 않는다.

리버티 스킨을 사용하다가 문제가 발생한 경우, [[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!/리버티 스킨]] 문서를 먼저 확인해 보고, 안되면 [https://discord.gg/GtzHUtt 리브레 위키 디스코드]방에 물어보자.

가온 위키:대문

2024-05-11T07:31:33Z

Admin: 서버 점검 완료

가온 위키:대문

2024-05-11T03:54:12Z

Admin: 서버 점검 중

<div style="border-top: 10px solid #00BCD4; padding: 3px; box-shadow: 3px 3px 13px #B3B3B3; text-align: center; border-radius:10px;>
<div>
<big>모두의 <s>마블</s>, 가온 위키!<br><br></big>

<p style="margin-top: -20px; font-size: 25px;>[[가온 위키]]에 오신 것을<br>환영합니다!</p>
</div>
<big>[[가온 위키]]는 누구든 참여 할 수 있는 위키 입니다!</big>
</div>

<br>

<hr />

<div id="notice" style="border: solid #e1e8ed; padding: 25px;">
{| class="mw-collapsible" style="margin: auto;"
| align="center" | <big><big><big><big>공지사항<br><br></big></big></big></big>
|-
| <big>'''서버 업그레이드 및 점검 중입니다. 점검 중에는 연결이 불안정 할 수 있습니다.<br>신속히 끝내도록 하겠습니다. 자세한 내용은 [https://bbs.gaonwiki.com/notice/4855 공지사항]을 확인하시기 바랍니다!
|-
| <br>1. 외부 링크 클릭 시, 경고 알림이 뜨도록 개선했어요!
|-
| <br>2. [[2023 문법 개선 프로젝트|사용법]] 을 확인해 보세요!
|-
| <br>3. 미디어위키 버전 업그레이드를 진행했어요!
|-
| align="center" | <hr /> 자세한 내용은<br> [https://bbs.gaonwiki.com/notice 공지사항 게시판]을 확인해 주세요!
|}
</div>

명악역

2024-01-08T04:33:34Z

Admin: 시작

== 개요 ==
프레데릭이 {{날짜/출력|2021-04-28}}에 공개한 곡.

== 영상 ==
<youtube>nHRoikIn880</youtube>

== 가사 ==
{| class="wikitable"
| '''思い出にされるくらいなら二度とあなたに歌わないよ'''<br>
오모이데니 사레루 쿠라이나라 니도토 아나타니 우타와나이요<br>
추억으로 남게 될 거라면 다시는 당신에게 노래하지 않겠어<br>

'''演じてやったんだ'''<br>
엔지테 얏탄다<br>
연기했어<br>

'''すべてを演じてやったんだ'''<br>
스베테오 엔지테 얏탄다<br>
모든 것을 연기했어<br>

'''何かと素っ頓狂で頓珍漢な名演技であったんだ'''<br>
나니카토 슷톤쿄데 톤친칸나 메이엔기데 앗탄다<br>
이래저래 엉뚱하고 종잡을 수 없는 명연기를 했어<br>

'''愛してやったんだ'''<br>
아이시테 얏탄다<br>
사랑했어<br>

'''全てを愛してやったんだ'''<br>
스베테오 아이시테 얏탄다<br>
모든 것을 사랑했어<br>

'''何か光っているって気付いていたけど知らん顔をしたんだ'''<br>
나니카 히캇테이룻테 키즈이테 이타케도 시란 카오오 시탄다<br>
뭔가가 빛나고 있다는 걸 알고 있었으면서도 모르는 척했어<br>

'''最低な考えさこの感情さえも一丁前で'''<br>
사이테이나 칸가에사 코노 칸죠사에모 잇쵸마에데<br>
최악의 생각이야, 이 감정까지도 한 명 몫이라<br>

'''散々笑ってたんだそうじゃなきゃやってらんねーな'''<br>
산잔 와랏테탄다 소쟈나캬 얏테란네나<br>
엄청나게 웃었어, 그렇지 않으면 버틸 수가 없었어<br>

'''このまま僕は曖昧な最終回なんて過ごしたくはないよ'''<br>
코노 마마 보쿠와 아이마이나 사이슈카이 난테 스고시타쿠와 나이요<br>
이대로 나는 애매한 최종화 따위 보내주고 싶지 않아<br>

'''「色褪せはしない今が綺麗だった」って思い出にされるくらいなら'''<br>
이로아세와 시나이 이마가 키레이닷탓테 오모이데니 사레루 쿠라이나라<br>
「바래지 않는 지금이 아름다워」라고 추억 취급 당할 바에야<br>

'''二度とあなたに歌わないよ'''<br>
니도토 아나타니 우타와나이요<br>
다시는 당신에게 노래하지 않겠어<br>

'''ずっとわかっていた'''<br>
즛토 와캇테이타<br>
여태껏 알고 있었어<br>

'''すべてをずっとわかっていた'''<br>
스베테오 즛토 와캇테이타<br>
모든 것을 여태껏 알고 있었어<br>

'''心の表情さえも真相さえも名演技と知っていた'''<br>
코코로노 효죠사에모 신소사에모 메이엔기토 싯테이타<br>
마음의 표정도 진상도 명연기라는 걸 알고 있었어<br>

'''だから演じてやったんだ'''<br>
다카라 엔지테 얏탄다<br>
그래서 연기했어<br>

'''私も演じてやったんだ'''<br>
와타시모 엔지테 얏탄다<br>
나도 연기했어<br>

'''いまだにあなたの声を覚えているから'''<br>
이마다니 아나타노 코에오 오보에테이루카라<br>
지금도 당신의 목소리를 기억하고 있으니까<br>

'''最高の演者さんだこのノンフィクションを彩って'''<br>
사이코노 엔쟈산다 코노 논휘쿠숀오 이로돗테<br>
최고의 배우였어, 이 논픽션을 물들이며<br>

'''丁寧な感受性で最後まで信じあっていた'''<br>
테이네이나 칸쥬세이데 사이고마데 신지앗테이타<br>
정중한 감수성으로 마지막까지 서로를 믿었어<br>

'''あれから君は後悔や劣等感さえも正解に変えて'''<br>
아레카라 키미와 코카이야 렛토칸사에모 세이카이니 카에테<br>
그때부터 너는 후회와 열등감까지도 정답으로 바꾸며<br>

'''もっと強くなったかな私の知らない毎日で'''<br>
못토 츠요쿠 낫타카나 와타시노 시라나이 마이니치데<br>
더 강해졌을까, 나는 알 수 없는 매일 속에서<br>

'''このまま僕は'''<br>
코노 마마 보쿠와<br>
이대로 나는<br>

'''色褪せはしない今が'''<br>
이로아세와 시나이 이마가<br>
바래지 않는 지금이<br>

'''これから僕は後悔や劣等感さえも正解に変えて'''<br>
코레카라 보쿠와 코카이야 렛토칸사에모 세이카이니 카에테<br>
지금부터 나는 후회와 열등감까지도 정답으로 바꾸며<br>

'''「色褪せはしない今が綺麗だった」って'''<br>
이로아세와 시나이 이마가 키레이닷탓테<br>
「바래지 않는 지금이 아름다워」라고<br>

'''思い出にされるくらいなら'''<br>
오모이데니 사레루 쿠라이나라<br>
추억 취급 당할 바에야<br>

'''思い出を超えるくらいにさ'''<br>
오모이데오 코에루 쿠라이니사<br>
추억을 뛰어넘을 수 있을 정도로<br>

'''絶え間ない今を歌うから'''<br>
타에마나이 이마오 우타우카라<br>
끊임없는 지금을 노래할 테니까<br>

'''二度とあなたを忘れないよ'''<br>
니도토 아나타오 와스레나이요<br>
다시는 당신을 잊지 않겠어<br>

'''演じてやったんだ'''<br>
엔지테 얏탄다<br>
연기했어<br>

'''すべてを演じてやったんだ'''<br>
스베테오 엔지테 얏탄다<br>
모든 것을 연기했어<br>

'''まだ見ぬノンフィクションを脳に浮かべてその台本を置いた'''<br>
마다 미누 논휘쿠숀오 노니 우카베테 소노 다이혼오 오이타<br>
아직 보지 못한 논픽션을 머리에 떠올리며 대본을 두었어
|}

[https://lyricbot.tistory.com/427 가사봇 - 티스토리 | CC BY로 가져옴]

名悪役

2024-01-08T04:33:25Z

Admin: 문서 넘기기

#REDIRECT[[명악역]]

가온 위키:대문

2023-12-07T01:59:15Z

Admin: 패치노트 최신화

라이믹스/릴리즈 노트/2.1.3

2023-08-26T03:38:41Z

Admin: 문단 수준 오타 수정

2023년 08월 15일에 등록 된 릴리즈 노트입니다.

{{인용문|라이믹스 2.1 버전대의 버그 수정 및 기능 개선 릴리즈입니다.}}

== 새 기능과 변경 사항 ==

* '''인증 메일 사용시 가입 후 지정된 URL로 이동하지 않는 문제 수정''' ([https://github.com/rhymix/rhymix/issues/726 #726], [https://github.com/rhymix/rhymix/issues/949 #949], [https://github.com/rhymix/rhymix/issues/1735 #1735])
* 기본 레이아웃과 스킨에서 로그인 또는 회원가입 도중 오류가 발생할 경우, 화면 전환 없이 오류를 표시하도록 개선 ([https://github.com/rhymix/rhymix/issues/2055 #2055])
* 최대 100px로 고정된 회원 서명 영역의 높이를 관리자가 설정하거나, 제한을 해제할 수 있도록 개선 ([https://github.com/rhymix/rhymix/issues/2146 #2146])
* 관리자가 일반 회원의 알림 설정 화면에 접근하여 임의로 변경하는 기능 삭제 ([https://github.com/rhymix/rhymix/issues/1925 #1925], [https://github.com/rhymix/rhymix/issues/2148 #2148])
* <code>.vscode</code> 등 흔히 사용하는 경로를 <code>.gitignore</code>에 추가 ([https://github.com/rhymix/rhymix/issues/2149 #2149])
* '''쪽지 보내기, 친구 추가 등 회원 메뉴에서 연결되는 대부분의 화면을 현재 창에 열도록 변경''' ([https://github.com/rhymix/rhymix/issues/1732 #1732], [https://github.com/rhymix/rhymix/issues/2154 #2154])
** 단, 관리자 화면으로 연결되는 메뉴는 계속 새 창에 열립니다.
** 사용하시는 스킨이나 레이아웃에서 지원하지 않는다면 기존 방식대로 팝업창에 열릴 수 있습니다.
* 부자연스러운 일본어 표현 수정 {{깃허브|mariko-f}} ([https://github.com/rhymix/rhymix/pull/2156 #2156])
* 세션 키를 사용하는 보안 설정 삭제 ([https://github.com/rhymix/rhymix/pull/2157 #2157])
* 세션 쿠키에 항상 httpOnly 속성을 추가하도록 변경
* 자동 로그인 쿠키가 정상적으로 전달되지 않은 경우 다시 전달하도록 하여, 로그인 풀림 문제 개선
* 메뉴 추가시 자동 생성되는 MID에 board_tGd6r 등의 랜덤값이 아닌 board2, board3 등의 간결한 이름을 사용하도록 개선
* SimpleEditor에 유튜브 iframe 코드를 그대로 붙여넣어도 정상 인식하도록 개선 ([https://github.com/rhymix/rhymix/issues/2159 #2159])
* Object 클래스 참조, 따옴표 누락 등 오래된 서드파티 자료에서 자주 발생하는 오류를 감지하여 친절한 오류 메시지를 추가하도록 개선
* '''게시판과 페이지에 검색엔진 색인 허용 여부를 선택하는 옵션 추가'''
** 허용하지 않더라도 검색엔진을 차단하지는 않으며, <code>X-Robots-Tag: noindex</code> 헤더를 전송합니다.
** 따라서 검색에 노출되지 않을 뿐, 애드센스 크롤러 등이 접근하는 데는 영향을 주지 않습니다.

== 개발자를 위한 새 기능과 변경 사항 ==

* 알림센터에서 FCM을 사용하여 푸시 알림을 발송할 때, 알림 데이터를 "notification" 필드에 넣을지 선택하는 옵션을 제공합니다. ([https://github.com/rhymix/rhymix/issues/1933 #1933])
** "notification" 필드 없이 "data" 필드에만 넣으면 어플리케이션이나 프론트엔드에서 표시되는 알림을 좀더 유연하게 컨트롤할 수 있습니다.
* <code>MemberController->insertGroup()</code> 메소드와 <code>procMemberAdminInsertGroup()</code> 액션의 결과값에 group_srl 값이 추가되었습니다.
* 문서 분류(category) 편집 화면에서 카테고리 tree 구조를 불러올 때 ./files/cache/document_category/ 경로의 캐시파일을 직접 호출하지 않고 문서 모듈의 POST 액션을 사용하도록 변경되었습니다.
** 라이믹스 2.1.3부터 '''./files/cache/ 폴더 아래에 있는 .php 파일을 직접 호출하는 것은 금지됩니다.''' 아파치 사용시 .htaccess에 의해 자동으로 차단되며, nginx 사용시 rewrite 규칙을 업데이트하여야 차단됩니다.
** files/ 폴더 아래에 .php 파일을 생성하고 호출하는 기능을 전반적으로 축소할 예정이며, 미래에는 files 폴더 아래에 있는 모든 .php 파일을 직접 호출하는 것이 금지될 수도 있으니 참고하시기 바랍니다. 쓰기 가능한 경로에 실행 가능한 파일을 두는 것은 안전하지 않습니다(W^X).
* 쪽지 보내기, 친구 추가 등 팝업창에서 열던 화면을 현재 창에서 열도록 스킨을 수정할 경우, 폼을 표시하는 <code>disp 액션</code>과 폼을 제출하는 <code>proc 액션</code> 양쪽 모두 <code>window_type=self</code> 파라미터를 추가해 주어야 합니다. 이 파라미터를 추가하지 않을 경우 팝업창에서 열던 기존 방식의 스킨이라고 간주하고, 팝업창에 맞는 레이아웃을 표시하게 됩니다.
* 트랜잭션 안에서 실행되던 <code>document.insertDocument (before)</code> 트리거가 트랜잭션 바깥으로 이동했습니다. 예전에는 이 트리거에서 오류를 반환하면 트랜잭션을 중단시키고 다른 자료가 실행한 쿼리까지 롤백할 수 있었으나, 이제는 다른 쿼리에 영향을 주지 않습니다.
* <code>module.xml</code>에서 사용하는 <code>check_csrf</code>, <code>meta_noindex</code>, <code>admin_index</code> 등의 속성에서 하이픈(-), 언더바(_), camelCase 표현을 구분하지 않고 모두 허용하도록 변경되었습니다.
** <code>check-csrf="true"</code>, <code>check_csrf="Y"</code>, <code>checkCsrf="on"</code> 모두 동일한 의미입니다.
* '''module.xml에서 이벤트 핸들러(트리거)를 선언할 수 있도록 지원합니다.'''
** 더이상 트리거 등록 여부를 PHP에서 확인하고 일일이 등록해 줄 필요가 없습니다.
** 이벤트를 받을 클래스는 <code>controller</code>, <code>model</code> 등 XE 방식의 명칭을 입력해도 되고, 해당 모듈의 <code>네임스페이스(Rhymix\Modules\모듈명)</code> 아래에 있는 클래스명을 입력해도 됩니다. 신규 개발하는 모듈이라면 네임스페이스를 사용하는 것을 권장합니다.
** 이벤트 핸들러 삭제시에도 <code>module.xml</code>을 수정하면 "모듈 설정 완료" 클릭시 자동으로 삭제됩니다.
** 단, <code>module.xml</code>에 이벤트 핸들러가 하나라도 선언되어 있는 경우, 다른 방법으로 등록한 트리거는 삭제 대상으로 인식합니다.
** 예를 들어 아래의 예제에서 <code>beforeInsertDocument()</code> 메소드는 <code>Rhymix\Modules\모듈명\Controllers\EventHandlers</code> 클래스에 있고, 이 클래스는 <code>./modules/모듈명/controllers/EventHandlers.php</code> 파일에 선언되어 있다고 가정합니다.

<code><eventHandlers>
<eventHandler before="document.insertDocument" class="Controllers\EventHandlers" method="beforeInsertDocument" />
<eventHandler after="document.updateDocument" class="Controllers\EventHandlers" method="afterUpdateDocument" />
</eventHandlers></code>

* '''특정 액션 직전이나 직후에만 호출되는 이벤트 핸들러(트리거)를 선언할 수 있도록 지원합니다.'''
** 기존의 <code>moduleObject.proc (before, after)</code> 이벤트와 거의 동일한 시점에 호출되지만, 해당 액션일 때만 호출됩니다.
** 모듈을 로딩한 후 <code>$act</code> 값을 확인하는 불필요한 과정과 자원 낭비를 피할 수 있습니다.
** <code>module.xml</code>에서 선언할 수도 있고, <code>PHP</code>에서 등록할 수도 있습니다. PHP에서는 트리거명을 "<code>act:모듈명.액션명</code>"으로 지정하면 됩니다.

<code><eventHandlers>
<eventHandler beforeAction="module.dispHelloWorld" class="Controllers\EventHandlers" method="beforeHelloWorld" />
<eventHandler afterAction="module.dispHelloWorld" class="Controllers\EventHandlers" method="afterHelloWorld" />
</eventHandlers></code>

<code>ModuleController::getInstance()->insertTrigger(
'act:member.dispMemberInfo', $this->module, 'controller', 'triggerAfterMemberInfo', 'after'
);</code>

* 모듈에서 "<code>Rhymix\Modules\모듈명</code>"이 아닌 커스텀 네임스페이스를 선언할 수 있도록 지원합니다.
* 모듈에서 "<code>모듈명.class.php</code>" 대신 사용할 기본 클래스와 설치/업데이트 담당 클래스를 별도로 선언할 수 있도록 지원합니다.

== 버그 수정 ==

* 특정한 설정 상태에서 회원가입 폼의 이메일 주소 입력란이 읽기 전용으로 표시되는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2143 #2143])
* "내 알림 목록" 화면에서 알림을 클릭하더라도 읽음 처리되지 않는 문제 수정
* 알림센터와 관련된 3가지 회원 메뉴의 표시 조건에 일관성이 없는 문제 수정 ([https://github.com/rhymix/rhymix/issues/1925 #1925], [https://github.com/rhymix/rhymix/issues/2048 #2048])
* "자동 로그인 관리" 화면에 표시되는 운영체제 및 브라우저 정보가 최초 로그인 시점의 버전으로 고정되는 문제 수정
* PHP 8.x에서 발생하는 각종 경고 메시지 수정 ([https://github.com/rhymix/rhymix/issues/2150 #2150], [https://github.com/rhymix/rhymix/issues/2151 #2151], [https://github.com/rhymix/rhymix/issues/2153 #2153])
* 모듈이 한 번에 삭제되지 않는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2158 #2158])
* <code>_XE_LOCATION_</code> 상수를 사용하는 서드파티 자료와의 호환성 개선 ([https://github.com/rhymix/rhymix/issues/2160 #2160])
* 초 단위가 없는 타임스탬프를 <code>zdate()</code>이나 <code>ztime()</code>에 넘길 경우 현재 시각을 반환하는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2161 #2161])
* 일부 표준 시간대에서 <code>ISO 8601</code> 타임스탬프를 <code>zdate()</code>이나 <code>ztime()</code>에 넘길 경우 잘못된 표준 시간대로 해석하는 문제 수정
* 유튜브 <code>iframe</code> 코드의 <code>allow</code> 속성이 삭제되는 문제 수정
* 특정 서드파티 자료에서 통합검색을 <code>POST</code>로 요청하면 <code>CSRF 토큰</code> 누락으로 인한 보안 오류가 발생하는 문제 수정
** 통합검색을 <code>POST</code>로 요청하는 것은 권장하지 않으며, <code>POST</code>로 요청하더라도 <code>GET</code>으로 강제 리다이렉트됩니다.
* 치명적인 오류 발생시 실제 오류 발생 위치가 아닌 Debug 클래스의 파일명과 줄 번호가 표시되는 문제 수정
* 스팸 키워드 때문에 글 작성이 차단되더라도 스팸필터 모듈에서 해당 키워드의 히트수가 증가하지 않는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2163 #2163])
* 대시보드에서 "모듈 설정 완료"를 클릭하더라도 모듈의 전역 짧은주소 설정이 적용되지 않을 수 있는 문제 수정
* <code>update_all_modules.php</code> 스크립트 사용시 모듈의 전역 짧은주소 설정이 적용되지 않는 문제 수정
* crontab 스크립트가 <code>Context::init()</code>을 호출하지 않은 채 넘어가는 문제 수정
* 분류를 선택하지 않고 글을 작성하려고 할 때, 상황에 따라 한글 메시지가 아닌 "categoryneeded"라는 영문 코드가 노출되는 문제 수정
* 보안 설정에서 nofollow가 켜져 있는 경우 유닛 테스트가 실패하는 문제 수정

== 정리 ==

* 직관적이지 않은 알림센터의 "수신 거부 리스트" 메뉴명을 "알림 수신 거부"로 변경
* 기본 레이아웃 및 통합검색 모듈의 예제 코드에서 불필요한 vid 파라미터 삭제
* root 권한으로 crontab 스크립트 실행시, 에러 메시지의 "<code>'''NOT'''</code>"을 강조하여 잘못 해석하는 것을 방지
* 분류 기능 사용을 임시 중단하는 옵션에 대한 설명 보완 ([https://github.com/rhymix/rhymix/issues/2164 #2164])

라이믹스/릴리즈 노트/2.1.3

2023-08-26T03:37:29Z

Admin: 2.1.3 버전 릴리즈됨

2023년 08월 15일에 등록 된 릴리즈 노트입니다.

{{인용문|라이믹스 2.1 버전대의 버그 수정 및 기능 개선 릴리즈입니다.}}

=== '''새 기능과 변경 사항''' ===

* '''인증 메일 사용시 가입 후 지정된 URL로 이동하지 않는 문제 수정''' ([https://github.com/rhymix/rhymix/issues/726 #726], [https://github.com/rhymix/rhymix/issues/949 #949], [https://github.com/rhymix/rhymix/issues/1735 #1735])
* 기본 레이아웃과 스킨에서 로그인 또는 회원가입 도중 오류가 발생할 경우, 화면 전환 없이 오류를 표시하도록 개선 ([https://github.com/rhymix/rhymix/issues/2055 #2055])
* 최대 100px로 고정된 회원 서명 영역의 높이를 관리자가 설정하거나, 제한을 해제할 수 있도록 개선 ([https://github.com/rhymix/rhymix/issues/2146 #2146])
* 관리자가 일반 회원의 알림 설정 화면에 접근하여 임의로 변경하는 기능 삭제 ([https://github.com/rhymix/rhymix/issues/1925 #1925], [https://github.com/rhymix/rhymix/issues/2148 #2148])
* <code>.vscode</code> 등 흔히 사용하는 경로를 <code>.gitignore</code>에 추가 ([https://github.com/rhymix/rhymix/issues/2149 #2149])
* '''쪽지 보내기, 친구 추가 등 회원 메뉴에서 연결되는 대부분의 화면을 현재 창에 열도록 변경''' ([https://github.com/rhymix/rhymix/issues/1732 #1732], [https://github.com/rhymix/rhymix/issues/2154 #2154])
** 단, 관리자 화면으로 연결되는 메뉴는 계속 새 창에 열립니다.
** 사용하시는 스킨이나 레이아웃에서 지원하지 않는다면 기존 방식대로 팝업창에 열릴 수 있습니다.
* 부자연스러운 일본어 표현 수정 {{깃허브|mariko-f}} ([https://github.com/rhymix/rhymix/pull/2156 #2156])
* 세션 키를 사용하는 보안 설정 삭제 ([https://github.com/rhymix/rhymix/pull/2157 #2157])
* 세션 쿠키에 항상 httpOnly 속성을 추가하도록 변경
* 자동 로그인 쿠키가 정상적으로 전달되지 않은 경우 다시 전달하도록 하여, 로그인 풀림 문제 개선
* 메뉴 추가시 자동 생성되는 MID에 board_tGd6r 등의 랜덤값이 아닌 board2, board3 등의 간결한 이름을 사용하도록 개선
* SimpleEditor에 유튜브 iframe 코드를 그대로 붙여넣어도 정상 인식하도록 개선 ([https://github.com/rhymix/rhymix/issues/2159 #2159])
* Object 클래스 참조, 따옴표 누락 등 오래된 서드파티 자료에서 자주 발생하는 오류를 감지하여 친절한 오류 메시지를 추가하도록 개선
* '''게시판과 페이지에 검색엔진 색인 허용 여부를 선택하는 옵션 추가'''
** 허용하지 않더라도 검색엔진을 차단하지는 않으며, <code>X-Robots-Tag: noindex</code> 헤더를 전송합니다.
** 따라서 검색에 노출되지 않을 뿐, 애드센스 크롤러 등이 접근하는 데는 영향을 주지 않습니다.

=== '''개발자를 위한 새 기능과 변경 사항''' ===

* 알림센터에서 FCM을 사용하여 푸시 알림을 발송할 때, 알림 데이터를 "notification" 필드에 넣을지 선택하는 옵션을 제공합니다. ([https://github.com/rhymix/rhymix/issues/1933 #1933])
** "notification" 필드 없이 "data" 필드에만 넣으면 어플리케이션이나 프론트엔드에서 표시되는 알림을 좀더 유연하게 컨트롤할 수 있습니다.
* <code>MemberController->insertGroup()</code> 메소드와 <code>procMemberAdminInsertGroup()</code> 액션의 결과값에 group_srl 값이 추가되었습니다.
* 문서 분류(category) 편집 화면에서 카테고리 tree 구조를 불러올 때 ./files/cache/document_category/ 경로의 캐시파일을 직접 호출하지 않고 문서 모듈의 POST 액션을 사용하도록 변경되었습니다.
** 라이믹스 2.1.3부터 '''./files/cache/ 폴더 아래에 있는 .php 파일을 직접 호출하는 것은 금지됩니다.''' 아파치 사용시 .htaccess에 의해 자동으로 차단되며, nginx 사용시 rewrite 규칙을 업데이트하여야 차단됩니다.
** files/ 폴더 아래에 .php 파일을 생성하고 호출하는 기능을 전반적으로 축소할 예정이며, 미래에는 files 폴더 아래에 있는 모든 .php 파일을 직접 호출하는 것이 금지될 수도 있으니 참고하시기 바랍니다. 쓰기 가능한 경로에 실행 가능한 파일을 두는 것은 안전하지 않습니다(W^X).
* 쪽지 보내기, 친구 추가 등 팝업창에서 열던 화면을 현재 창에서 열도록 스킨을 수정할 경우, 폼을 표시하는 <code>disp 액션</code>과 폼을 제출하는 <code>proc 액션</code> 양쪽 모두 <code>window_type=self</code> 파라미터를 추가해 주어야 합니다. 이 파라미터를 추가하지 않을 경우 팝업창에서 열던 기존 방식의 스킨이라고 간주하고, 팝업창에 맞는 레이아웃을 표시하게 됩니다.
* 트랜잭션 안에서 실행되던 <code>document.insertDocument (before)</code> 트리거가 트랜잭션 바깥으로 이동했습니다. 예전에는 이 트리거에서 오류를 반환하면 트랜잭션을 중단시키고 다른 자료가 실행한 쿼리까지 롤백할 수 있었으나, 이제는 다른 쿼리에 영향을 주지 않습니다.
* <code>module.xml</code>에서 사용하는 <code>check_csrf</code>, <code>meta_noindex</code>, <code>admin_index</code> 등의 속성에서 하이픈(-), 언더바(_), camelCase 표현을 구분하지 않고 모두 허용하도록 변경되었습니다.
** <code>check-csrf="true"</code>, <code>check_csrf="Y"</code>, <code>checkCsrf="on"</code> 모두 동일한 의미입니다.
* '''module.xml에서 이벤트 핸들러(트리거)를 선언할 수 있도록 지원합니다.'''
** 더이상 트리거 등록 여부를 PHP에서 확인하고 일일이 등록해 줄 필요가 없습니다.
** 이벤트를 받을 클래스는 <code>controller</code>, <code>model</code> 등 XE 방식의 명칭을 입력해도 되고, 해당 모듈의 <code>네임스페이스(Rhymix\Modules\모듈명)</code> 아래에 있는 클래스명을 입력해도 됩니다. 신규 개발하는 모듈이라면 네임스페이스를 사용하는 것을 권장합니다.
** 이벤트 핸들러 삭제시에도 <code>module.xml</code>을 수정하면 "모듈 설정 완료" 클릭시 자동으로 삭제됩니다.
** 단, <code>module.xml</code>에 이벤트 핸들러가 하나라도 선언되어 있는 경우, 다른 방법으로 등록한 트리거는 삭제 대상으로 인식합니다.
** 예를 들어 아래의 예제에서 <code>beforeInsertDocument()</code> 메소드는 <code>Rhymix\Modules\모듈명\Controllers\EventHandlers</code> 클래스에 있고, 이 클래스는 <code>./modules/모듈명/controllers/EventHandlers.php</code> 파일에 선언되어 있다고 가정합니다.

<code><eventHandlers>
<eventHandler before="document.insertDocument" class="Controllers\EventHandlers" method="beforeInsertDocument" />
<eventHandler after="document.updateDocument" class="Controllers\EventHandlers" method="afterUpdateDocument" />
</eventHandlers></code>

* '''특정 액션 직전이나 직후에만 호출되는 이벤트 핸들러(트리거)를 선언할 수 있도록 지원합니다.'''
** 기존의 <code>moduleObject.proc (before, after)</code> 이벤트와 거의 동일한 시점에 호출되지만, 해당 액션일 때만 호출됩니다.
** 모듈을 로딩한 후 <code>$act</code> 값을 확인하는 불필요한 과정과 자원 낭비를 피할 수 있습니다.
** <code>module.xml</code>에서 선언할 수도 있고, <code>PHP</code>에서 등록할 수도 있습니다. PHP에서는 트리거명을 "<code>act:모듈명.액션명</code>"으로 지정하면 됩니다.

<code><eventHandlers>
<eventHandler beforeAction="module.dispHelloWorld" class="Controllers\EventHandlers" method="beforeHelloWorld" />
<eventHandler afterAction="module.dispHelloWorld" class="Controllers\EventHandlers" method="afterHelloWorld" />
</eventHandlers></code>

<code>ModuleController::getInstance()->insertTrigger(
'act:member.dispMemberInfo', $this->module, 'controller', 'triggerAfterMemberInfo', 'after'
);</code>

* 모듈에서 "<code>Rhymix\Modules\모듈명</code>"이 아닌 커스텀 네임스페이스를 선언할 수 있도록 지원합니다.
* 모듈에서 "<code>모듈명.class.php</code>" 대신 사용할 기본 클래스와 설치/업데이트 담당 클래스를 별도로 선언할 수 있도록 지원합니다.

=== '''버그 수정''' ===

* 특정한 설정 상태에서 회원가입 폼의 이메일 주소 입력란이 읽기 전용으로 표시되는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2143 #2143])
* "내 알림 목록" 화면에서 알림을 클릭하더라도 읽음 처리되지 않는 문제 수정
* 알림센터와 관련된 3가지 회원 메뉴의 표시 조건에 일관성이 없는 문제 수정 ([https://github.com/rhymix/rhymix/issues/1925 #1925], [https://github.com/rhymix/rhymix/issues/2048 #2048])
* "자동 로그인 관리" 화면에 표시되는 운영체제 및 브라우저 정보가 최초 로그인 시점의 버전으로 고정되는 문제 수정
* PHP 8.x에서 발생하는 각종 경고 메시지 수정 ([https://github.com/rhymix/rhymix/issues/2150 #2150], [https://github.com/rhymix/rhymix/issues/2151 #2151], [https://github.com/rhymix/rhymix/issues/2153 #2153])
* 모듈이 한 번에 삭제되지 않는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2158 #2158])
* <code>_XE_LOCATION_</code> 상수를 사용하는 서드파티 자료와의 호환성 개선 ([https://github.com/rhymix/rhymix/issues/2160 #2160])
* 초 단위가 없는 타임스탬프를 <code>zdate()</code>이나 <code>ztime()</code>에 넘길 경우 현재 시각을 반환하는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2161 #2161])
* 일부 표준 시간대에서 <code>ISO 8601</code> 타임스탬프를 <code>zdate()</code>이나 <code>ztime()</code>에 넘길 경우 잘못된 표준 시간대로 해석하는 문제 수정
* 유튜브 <code>iframe</code> 코드의 <code>allow</code> 속성이 삭제되는 문제 수정
* 특정 서드파티 자료에서 통합검색을 <code>POST</code>로 요청하면 <code>CSRF 토큰</code> 누락으로 인한 보안 오류가 발생하는 문제 수정
** 통합검색을 <code>POST</code>로 요청하는 것은 권장하지 않으며, <code>POST</code>로 요청하더라도 <code>GET</code>으로 강제 리다이렉트됩니다.
* 치명적인 오류 발생시 실제 오류 발생 위치가 아닌 Debug 클래스의 파일명과 줄 번호가 표시되는 문제 수정
* 스팸 키워드 때문에 글 작성이 차단되더라도 스팸필터 모듈에서 해당 키워드의 히트수가 증가하지 않는 문제 수정 ([https://github.com/rhymix/rhymix/issues/2163 #2163])
* 대시보드에서 "모듈 설정 완료"를 클릭하더라도 모듈의 전역 짧은주소 설정이 적용되지 않을 수 있는 문제 수정
* <code>update_all_modules.php</code> 스크립트 사용시 모듈의 전역 짧은주소 설정이 적용되지 않는 문제 수정
* crontab 스크립트가 <code>Context::init()</code>을 호출하지 않은 채 넘어가는 문제 수정
* 분류를 선택하지 않고 글을 작성하려고 할 때, 상황에 따라 한글 메시지가 아닌 "categoryneeded"라는 영문 코드가 노출되는 문제 수정
* 보안 설정에서 nofollow가 켜져 있는 경우 유닛 테스트가 실패하는 문제 수정

=== '''정리''' ===

* 직관적이지 않은 알림센터의 "수신 거부 리스트" 메뉴명을 "알림 수신 거부"로 변경
* 기본 레이아웃 및 통합검색 모듈의 예제 코드에서 불필요한 vid 파라미터 삭제
* root 권한으로 crontab 스크립트 실행시, 에러 메시지의 "<code>'''NOT'''</code>"을 강조하여 잘못 해석하는 것을 방지
* 분류 기능 사용을 임시 중단하는 옵션에 대한 설명 보완 ([https://github.com/rhymix/rhymix/issues/2164 #2164])

2023 문법 개선 프로젝트

2023-08-03T04:25:07Z

Admin: /* 해시갑 계산 */ 오타 수정

== 개요 ==
[[2023년 위키 개선 프로젝트]]의 일환으로서 기존의 부족한 위키 문법을 개선했습니다. 각 문법 별 사용 방법과 표시 결과를 출력합니다.

== 수학 ==
=== 평균 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average></nowiki>
| <average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average>
|-
! 입력값
! 출력값
|}

<code><nowiki><average></average></nowiki></code> 태그 안에 있는 숫자들의 평균을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 중앙값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median></nowiki>
| <median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median>
|-
! 입력값
! 출력값
|}

<code><nowiki><median></median></nowiki></code> 태그 안에 있는 숫자들의 중앙값을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 최빈값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode></nowiki>
| <mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode>
|-
! 입력값
! 출력값
|}

<code><nowiki><mode></mode></nowiki></code> 태그 안에 있는 숫자들의 최빈값울 출력합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, 최빈값이 존재하지 않는 경우<ref>모두 1개씩만 있는 경우</ref>에는 모든 숫자들이 출력<ref>작은 숫자부터 큰 숫자로 정렬되어 출력</ref>이 됩니다.

=== 올림, 반올림, 버림 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><ceil>161.3</ceil></nowiki><br><nowiki><round>53.5</round></nowiki><br><nowiki><floor>23.9</floor></nowiki>
| <ceil>161.3</ceil><br><round>53.5</round><br><floor>23.9</floor>
|-
! 입력값
! 출력값
|}

소수점 아래의 숫자를 보고 '''올림/반올림/버림'''을 합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, '''","'''로 값을 여러개 입력하더라도 계산되어 출력되는 것은 맨 처음 입력된 값입니다.

=== 원주율 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><pi></pi></nowiki>
| <pi></pi>
|-
! 입력값
! 출력값
|}

원주율(<math>\pi</math>)을 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><pi>5</pi></code> 이렇게 입력하면 '''<pi>5</pi>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 로그 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><log2></log2></nowiki>
| <log2></log2>
|-
! 입력값
! 출력값
|}

로그 2(<math>log2</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><log2>5</log2></code> 이렇게 입력하면 '''<log2>5</log2>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 루트 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><sqrt2></sqrt2></nowiki>
| <sqrt2></sqrt2>
|-
! 입력값
! 출력값
|}

루트 2(<math>\sqrt{2}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><sqrt2>5</sqrt2></code> 이렇게 입력하면 '''<sqrt2>5</sqrt2> '''이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 자연로그 밑 e ===
{| class="wikitable" style="text-align: center;"
| <nowiki><euler></euler></nowiki>
| <euler></euler>
|-
! 입력값
! 출력값
|}

루트 2(<math>{e}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><euler>5</euler></code> 이렇게 입력하면 '''<euler>5</euler>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 수식 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mathcalc>2+3*sqrt(4)</mathcalc></nowiki>
| <mathcalc>2+3*sqrt(4)</mathcalc>
|-
! 입력값
! 출력값
|}

자바스크립트 Math.js 라이브러리로 계산한 값을 출력합니다. 서버에서 계산하지 않으므로 계산값이 출력되는데 약간의 시간이 걸리며, 자바스크립트를 사용하지 않는 매우매우 드문 유저는 사용할 수 없습니다.

== 날짜 ==
=== 현재 날짜 및 시간 출력 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><date></date></nowiki>
| <date></date>
|-
! 입력값
! 출력값
|}

현재 날짜를 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

{| class="wikitable" style="text-align: center;"
| <nowiki><datetime></datetime></nowiki>
| <datetime></datetime>
|-
! 입력값
! 출력값
|}

현재 날짜와 시간값을 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

==== 서버 시간 표시 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><svrtime></svrtime></nowiki><br><nowiki><svrtime>Asia/Seoul</svrtime></nowiki><br><nowiki><svrtime>PHP</svrtime></nowiki><br><nowiki><svrtime>WIKI</svrtime></nowiki>
| <svrtime></svrtime><br><svrtime>Asia/Seoul</svrtime><br><svrtime>PHP</svrtime><br><svrtime>WIKI</svrtime>
|-
! 입력값
! 출력값
|}

서버 시간을 기준으로 현재 시간을 출력합니다.<ref>위의 <code><nowiki><datetime></datetime></nowiki></code>도 마찬가지로 서버 시간으로 현재 시간을 출력함</ref> 다만 <code><nowiki><datetime></datetime></nowiki></code>와 달리 시간대를 선택할 수 있습니다.

<svrtime></svrtime> → 현재 서버 시간 표시(시간대는 서버가 사용중인 시간대)
<svrtime>Asia/Seoul</svrtime> → 현재 서버 시간 표시(시간대는 Asia/Seoul)
<svrtime>PHP</svrtime> → 현재 서버 시간 표시(PHP 시간 정보, php는 대소문자 구분 안함)
<svrtime>WIKI</svrtime> → 현재 서버 시간 표시(위키의 시간대를 이용한 시간 표시, WIKI 대소문자 구분 안함)

=== 날짜 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc></nowiki><br><nowiki><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc></nowiki>
| <datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc><br><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc>
|-
! 입력값
! 출력값
|}

기준 날짜 또는 기준 날짜 및 시간을 입력 후 이후의 연월일 값을 입력하면 그 이후의 날짜를 출력합니다. 다만 태그 안에 값을 입력하지 않거나, 기준 날짜(및 시간)을 입력하지 않은 경우, 이후의 연원일 값을 입력하지 않으면 <code>Error: Invalid input</code>라고 출력이 됩니다.

기준 날짜(시간값을 지정하지 않은 경우)에 연월일 + 시간값을 더하면, 결과값은 KST 기준 현재 시간값으로 계산됩니다.

=== 만 나이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><age>1975-00-00</age></nowiki><br><nowiki><age>1975-07-00</age></nowiki><br><nowiki><age>1975-07-20</age></nowiki>
| <age>1975-00-00</age><br><age>1975-07-00</age><br><age>1975-07-20</age>
|-
! 입력값
! 출력값
|}

만 나이를 계산합니다. 기본적으로 생년월일을 입력하면 현재 날짜 기준으로 만나이를 계산하며, KST를 기준으로 합니다. 만약 연도와 달 또는 연도만 아는 경우, 나머지 모르는 부분에 00을 입력하면 대략적인 만나이를 출력합니다. 만약 태그 안에 값을 입력하지 않으면 <code>Error: No date value provided.</code>라고 출력되고, 날짜 포맷에 맞추어 입력하지 않으면 <code>Error: Date format is incorrect. Please use 'YYYY-MM-DD'.</code>라고 출력됩니다.

=== 디데이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><dday>2030-10-20</dday></nowiki>
| <dday>2030-10-20</dday>
|-
! 입력값
! 출력값
|}

현재 날짜를 기준으로 태그 안의 날짜까지 얼마나 남았는지 일수를 알려줍니다. 연도의 범위는 0부터 9999까지이며, 이 범위를 넘은 값을 입력하면 <code>Invalid year in date</code> 라는 메시지를 띄우도록 설계되어 있지만, <code>-8258 days 13 hours 0 minutes 37 seconds ago</code> 이렇게 출력이 될 수도 있습니다. PHP의 한계이므로 양해 부탁드립니다. 태그 안에 아무런 값을 입력하지 않으면 <code>No date provided in the tag.</code> 라고 출력됩니다.

=== 윤년 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><leapyear>2030-10-20</leapyear></nowiki>
| <leapyear>2030-10-20</leapyear>
|-
! 입력값
! 출력값
|}

연도 또는 날짜를 입력하면, 해당 연도가 윤년인지 여부를 출력합니다. 윤년인 경우 <code>True</code>를, 윤년이 아닌 경우 <code>False</code>를 반환합니다.

== 글자 ==
=== 요소 정렬 ===
'''입력값: ''' <nowiki><float val='left'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='left'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='center'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='center'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='tcenter'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='tcenter'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='right'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='right'>Hello, world!</float><br>

요소를 왼쪽, 중앙, 가운데로 정렬할 수 있습니다. 요소의 css 중 <code>float</code> 속성을 지정하며, <code>center는</code> <code>float</code>가 아닌 <code>margin: auto</code>로 설정합니다. <code>tcenter</code>는 <code>text center</code>의 뜻으로 <code>margin: auto</code> 뿐만 아니라 <code>text-align: auto</code> 까지 부여합니다.

=== 세로 쓰기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><vertical>안녕하세요, 가온이에요!</vertical></nowiki>
| <vertical>안녕하세요, 가온이에요!</vertical>
|-
! 입력값
! 출력값
|}

태그 안의 값을 세로로 위치시킵니다.

=== 요소 움직이기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase></nowiki>
| <mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase>
|-
! 입력값
! 출력값
|}

요소를 왼쪽 또는 오른쪽으로 움직이는 애니메이션 효과를 줄 수 있습니다. <code>direction</code> 속성에는 움직일 방향을 정의<ref><code>left</code> 또는 <code>right</code></ref>하고, <code>speed</code>에는 움직임 속도를 정의합니다. 각 속성의 기본값은 <code>left</code>와 <code>100</code>이며, 기본 움직임 속도가 매우 빠르기 때문에 속도값을 많이 줄이는 것을 권장합니다.

=== 글자 블러 처리 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><blur>안녕하세요, 가온이에요!</blur></nowiki>
| <blur>안녕하세요, 가온이에요!</blur>
|-
! 입력값
! 출력값
|}

글자를 블러 처리할 수 있습니다. 태그 안에 값을 입력하면 블러 처리가 되며, 내외부 링크 모두 동작합니다. 마우스로 블러 처리된 부분 위로 가져다 놓으면 블러가 잠깐 해제됩니다.

분류는 본 방식으로 블러 처리가 되지 않습니다. 분류에서의 블러 처리는 아래의 문단을 확인하시기 바랍니다.

==== 분류 블러 ====
{| class="wikitable" style="text-align: center;"
| <nowiki>[[분류:블러 처리 된 분류@@blur]]</nowiki>
| [[분류:블러 처리 된 분류@@blur]] 상단 분류값 확인
|-
! 입력값
! 출력값
|}

분류 중에 블러 처리를 하기 원하는 경우, 분류명 맨 뒤에 <code><nowiki>@@blur</nowiki></code>를 붙이면, 블러 처리가 됩니다. 단, 자바스크립트를 허용(기본적으로는 허용되어 있음)해야만 작동하며, 자바스크립트에서 처리하기 때문에 약간의 시간이 걸릴 수 있습니다.

=== 해시값 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><hash type="sha256">안녕하세요</hash></nowiki>
| <hash type="sha256">안녕하세요</hash>
|-
! 입력값
! 출력값
|}

태그 안의 값을 <code>type</code> 속성으로 지정한 해시 방식으로 해시화 한 뒤 결과값을 출력합니다. PHP 버전 및 모듈에 따라 다르지만, 가온 위키에서 사용 가능한 방식은 <code>md2 / md4 / md5 / sha1 / sha224 / sha256 / sha384 / sha512/224 / sha512/256 / sha512 / sha3-224 / sha3-256 / sha3-384 / sha3-512 / ripemd128 / ripemd160 / ripemd256 / ripemd320 / whirlpool / tiger128,3 / tiger160,3 / tiger192,3 / tiger128,4 / tiger160,4 / tiger192,4 / snefru / snefru256 / gost / gost-crypto / adler32 / crc32 / crc32b / crc32c / fnv132 / fnv1a32 / fnv164 / fnv1a64 / joaat / haval128,3 / haval160,3 / haval192,3 / haval224,3 / haval256,3 / haval128,4 / haval160,4 / haval192,4 / haval224,4 / haval256,4 / haval128,5 / haval160,5 / haval192,5 / haval224,5 / haval256,5</code>가 있습니다.

=== 접기 펼치기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><folding>안녕하세요</folding></nowiki><br><nowiki><folding>제목||내용입니다</folding></nowiki>
| <folding>안녕하세요</folding><br><folding>제목||내용입니다</folding>
|-
! 입력값
! 출력값
|}

내용이 길어 접었다가 상세한 내용을 보기를 원하는 사용자가 클릭하면 숨겨진 내용이 나오도록 할 수 있습니다. 제목과 내용 부분은 <code>||</code>로 구분하며, 만약 구분하지 않고 내용만 입력하면 '''[접기 · 펼치기]''' 가 제목으로 나오게 됩니다.

=== 아스키 유니코드 변환 ===
==== 아스키 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><ascii type="str" to="10">h</ascii></nowiki>
| <ascii type="str" to="10">h</ascii>
|-
! 입력값
! 출력값
|}

아스키 코드를 변환합니다. <code><ascii type="{문자(str)/10진수(10)/16진수(16)}" to="{문자(str)/10진수(10)/16진수(16)}">값</ascii></code> 형태로 입력하며, 여러 값이 있더라도 맨 첫번째 값<ref>hello라고 입력하면 h</ref>만 계산됩니다.

==== 유니코드 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode></nowiki>
| <unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode>
|-
! 입력값
! 출력값
|}

유니코드를 변환합니다. 유니코드 값을 <code>U+XXXX</code> 형태로 입력하면 그 값을 반환합니다.

=== 문자열 길이 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><len>Pneumonoultramicroscopicsilicovolcanoconiosis</len></nowiki>
| <len>Pneumonoultramicroscopicsilicovolcanoconiosis</len>
|-
! 입력값
! 출력값
|}

문자열의 길이를 반환합니다. 띄어쓰기와 특수문자를 모두 반영합니다.

=== 문자열 갯수 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count></nowiki>
| <count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count>
|-
! 입력값
! 출력값
|}

원하는 문자열이 몇개 들어있는지를 반환합니다. 대소문자를 구분합니다.

=== 전부 대(소)문자로 변환 ===
==== 전부 대문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><upper>hello i am a boy!</upper></nowiki>
| <upper>hello i am a boy!</upper>
|-
! 입력값
! 출력값
|}

모든 글자를 대문자로 변환합니다.

==== 전부 소문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><lower>HELLO MR MY YESTERDAY</lower></nowiki>
| <lower>HELLO MR MY YESTERDAY</lower>
|-
! 입력값
! 출력값
|}

모든 글자를 소문자로 변환합니다.

=== 대(소)문자 여부 ===
==== 대문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><isupper>HELLO I AM A BOY!</isupper></nowiki>
| <isupper>HELLO I AM A BOY!</isupper>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 대문자인 경우 <code>True</code>를, 소문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

==== 소문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><islower>hello Mr my yesterday</islower></nowiki>
| <islower>hello Mr my yesterday</islower>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 소문자인 경우 <code>True</code>를, 대문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

=== 문자열 뒤집기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><reverse>Hello</reverse></nowiki>
| <reverse>Hello</reverse>
|-
! 입력값
! 출력값
|}

입력한 문자열을 뒤집어 출력합니다.

=== 공백 제거 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces></nowiki>
| <rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces>
|-
! 입력값
! 출력값
|}

공백을 제거합니다.

=== 정렬 ===
==== 오름차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-asc>Friendship</sort-asc></nowiki>
| <sort-asc>Friendship</sort-asc>
|-
! 입력값
! 출력값
|}

오름차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 대문자가 우선합니다.

==== 내림차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-desc>Friendship</sort-desc></nowiki>
| <sort-desc>Friendship</sort-desc>
|-
! 입력값
! 출력값
|}

내림차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 소문자가 우선합니다.

=== 글자 및 배경색 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><wordclr color="red" bg="yellow">Hello, world!</wordclr></nowiki>
| <wordclr color="red" bg="yellow">Hello, world!</wordclr>
|-
! 입력값
! 출력값
|}

글자 색과 배경색을 지정할 수 있습니다. <code>color</code>값을 지정하지 않으면 <code>black</code>으로, <code>bg</code>를 지정하지 않으면 투명(없음)으로 설정됩니다.

=== URL 인코딩 디코딩 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><urlencode>안녕하세요!</urlencode></nowiki><br><nowiki><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode></nowiki>
| <urlencode>안녕하세요!</urlencode><br><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode>
|-
! 입력값
! 출력값
|}

url 값을 인코딩 시키거나 디코딩 시켜서 반환합니다.

=== 마크다운 뱃지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mdbadge type='language' value='php'></mdbadge></nowiki>
| <mdbadge type='language' value='php'></mdbadge>
|-
! 입력값
! 출력값
|}

깃허브 등에서 마크다운으로 뱃지를 넣는 것을 보고 착안했습니다. 사용 가능한 <code>type</code>은 <code>'build', 'code Coverage', 'language', 'test Results', 'analysis', 'chat', 'dependencies', 'size', 'downloads', 'funding', 'issue_tracking', 'license', 'rating', 'social', 'version', 'platform', 'monitoring', 'activity', 'custom'</code>이 있으며, 각 <code>type</code>별로 색상이 다릅니다.

== 랜덤 ==
=== 퍼센트 별 출력 메시지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random></nowiki>
| <random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자로 값을 입력하면, 해당 확률에 따라 <code>True</code> 또는 <code>False</code> 여부를 확인 후, 사용자가 설정한 문구가 나오도록 합니다. 새로고침 할 때마다 확률을 다시 계산합니다.

=== 랜덤 뽑기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><draw range="1-15" count="5" duplication="true"></draw></nowiki>
| <draw range="1-15" count="5" duplication="true"></draw>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자 범위를 입력하고, <code>count</code>에는 몇 개를 뽑을 것인지 선택하면, 랜덤하게 숫자를 뽑아줍니다. <code>duplication</code> 옵션은 중복을 허용할 것인지 이며, 입력하지 않은 경우 중복을 허용하지 않습니다.

<code>range</code> 내의 숫자보다 <code>count</code>의 갯수가 적은 경우, 예를 들어 <code>range</code>가 <code>1~5</code>이고, <code>count</code>가 <code>10</code>이면, 5개만 나오게 됩니다.

마찬가지로 새로고침 할 때마다 새로 뽑습니다.

=== 랜덤 문자열 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rdstr sets="up,num" len="20"></rdstr></nowiki>
| <rdstr sets="up,num" len="20"></rdstr>
|-
! 입력값
! 출력값
|}

랜덤한 문자열을 생성합니다. <code>sets</code>에는 어떤 문자를 넣을 것인지, <code>len</code>은 글자 수를 설정하는 것이며, <code>sets</code>에는 <code>up</code><ref>대문자</ref>, <code>low</code><ref>소문자</ref>, <code>num</code><ref>숫자</ref> 중에서 1개 이상을 입력하면 됩니다. 마찬가지로 새로고침 할 때마다 새로 생성합니다.

== 기타 ==
=== Progress Bar 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar></nowiki>
|-
! 입력값
|-
| <progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar>
|-
! 출력값
|}

Progress Bar를 생성합니다. <code>percent</code>에는 progress bar의 퍼센테이지<ref>전체를 100%로 보았을 때의 퍼센테이지를 입력</ref>, <code>value</code>에는 바 안에 출력할 값을, <code>color</code>는 바의 색상, <code>width</code>는 가로 길이, <code>height</code>는 세로 길이를 정의합니다.

<code>percent</code>는 필수로 입력해야 하고, 나머지 요소들을 선택사항 입니다. <code>color</code>의 기본값은 <code>#00BCD4</code>이고 <code>width</code>의 기본값은 <code>100%</code>, <code>height</code>의 기본값은 <code>20px</code> 입니다.

=== 컬러 팔레트 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><colorpalette type="rgb">125,32,80</colorpalette></nowiki>
| <colorpalette type="rgb">125,32,80</colorpalette>
|-
! 입력값
! 출력값
|}

입력한 색상 값을 출력합니다. <code>type</code>에는 <code>rgb</code>, <code>hex</code>, <code>cmyk</code> 중 하나를 선택할 수 있으며, 입력하지 않는 경우 기본값은 <code>rgb</code> 입니다. 색상은 가로-세로 5em-1em 영역에 표시가 됩니다.

<code>rgb</code>는 <code>alpha</code> 채널도 지원합니다.

== 각주 ==


[[분류:문법 개선]]

新서울합작

2023-07-25T07:36:16Z

Admin: 토론 종료

[[분류:수도권의 교통합성 합작]]
[[분류:인터넷/밈]]

= 소개 =
'新서울합작'은 한국의 교통합성 합작 프로젝트로서, 서울을 대표하는 새로운 교통합성 합작을 만드는 것을 목표로 한다.

= 인원 모집 근황 =
현재 디스코드에서 인원을 모집하고 있으며, 아직은 2명밖에 못 모았다. 그리고 그 2명중 한명은 아직 심사를 안봤다.

= 타 커뮤니티에서의 인지도 =

== 쿨엔조이에서의 인지도 ==
2023년 7월 24일 월요일 밤 23시 5분 기준으로, 36% 정도 있다.

근데 날이 밝을수록 계속 낮아지고있다.

= 유튜브에서의 인지도 =
2023년 7월 24일 월요일 밤 23시 5분 기준으로, 10% 정도 있다.

= 합작명에 대한 고민 =
합작 인원 모집을 시작하던 날에는 합작명에 대해 고민을 정말 많이 했다.
지금까지 총 서울합작, 경기합작, 수도권합작 등 3개의 후보가 있었지만, 모두 탈락되었다. 이유는 '합작명의 탈락 사유' 파트를 참고하길 바란다.

== 합작명의 탈락 사유 ==
이유는 다음 파트를 참고하길 바란다.

=== 서울합작 ===
마음에 안 들어서 탈락되었다.

=== 경기합작 ===
서울합작을 만들고싶어서 탈락되었다.

=== 수도권합작 ===
이름이 안 멋있어서 탈락되었다.

= 합작명의 변경 사유 =
사실 처음부터 '新서울합작' 이라는 합작명을 사용했던것은 아니다.
'新서울합작' 이라는 이름은 익명을 요청하신 분이 제안해주신 이름이다.

2023 문법 개선 프로젝트

2023-06-07T07:59:26Z

Admin: /* 최대값 최소값 */ 문자열로 취급되어 기능 구현 안됨

== 개요 ==
[[2023년 위키 개선 프로젝트]]의 일환으로서 기존의 부족한 위키 문법을 개선했습니다. 각 문법 별 사용 방법과 표시 결과를 출력합니다.

== 수학 ==
=== 평균 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average></nowiki>
| <average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average>
|-
! 입력값
! 출력값
|}

<code><nowiki><average></average></nowiki></code> 태그 안에 있는 숫자들의 평균을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 중앙값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median></nowiki>
| <median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median>
|-
! 입력값
! 출력값
|}

<code><nowiki><median></median></nowiki></code> 태그 안에 있는 숫자들의 중앙값을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 최빈값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode></nowiki>
| <mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode>
|-
! 입력값
! 출력값
|}

<code><nowiki><mode></mode></nowiki></code> 태그 안에 있는 숫자들의 최빈값울 출력합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, 최빈값이 존재하지 않는 경우<ref>모두 1개씩만 있는 경우</ref>에는 모든 숫자들이 출력<ref>작은 숫자부터 큰 숫자로 정렬되어 출력</ref>이 됩니다.

=== 올림, 반올림, 버림 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><ceil>161.3</ceil></nowiki><br><nowiki><round>53.5</round></nowiki><br><nowiki><floor>23.9</floor></nowiki>
| <ceil>161.3</ceil><br><round>53.5</round><br><floor>23.9</floor>
|-
! 입력값
! 출력값
|}

소수점 아래의 숫자를 보고 '''올림/반올림/버림'''을 합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, '''","'''로 값을 여러개 입력하더라도 계산되어 출력되는 것은 맨 처음 입력된 값입니다.

=== 원주율 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><pi></pi></nowiki>
| <pi></pi>
|-
! 입력값
! 출력값
|}

원주율(<math>\pi</math>)을 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><pi>5</pi></code> 이렇게 입력하면 '''<pi>5</pi>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 로그 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><log2></log2></nowiki>
| <log2></log2>
|-
! 입력값
! 출력값
|}

로그 2(<math>log2</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><log2>5</log2></code> 이렇게 입력하면 '''<log2>5</log2>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 루트 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><sqrt2></sqrt2></nowiki>
| <sqrt2></sqrt2>
|-
! 입력값
! 출력값
|}

루트 2(<math>\sqrt{2}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><sqrt2>5</sqrt2></code> 이렇게 입력하면 '''<sqrt2>5</sqrt2> '''이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 자연로그 밑 e ===
{| class="wikitable" style="text-align: center;"
| <nowiki><euler></euler></nowiki>
| <euler></euler>
|-
! 입력값
! 출력값
|}

루트 2(<math>{e}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><euler>5</euler></code> 이렇게 입력하면 '''<euler>5</euler>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 수식 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mathcalc>2+3*sqrt(4)</mathcalc></nowiki>
| <mathcalc>2+3*sqrt(4)</mathcalc>
|-
! 입력값
! 출력값
|}

자바스크립트 Math.js 라이브러리로 계산한 값을 출력합니다. 서버에서 계산하지 않으므로 계산값이 출력되는데 약간의 시간이 걸리며, 자바스크립트를 사용하지 않는 매우매우 드문 유저는 사용할 수 없습니다.

== 날짜 ==
=== 현재 날짜 및 시간 출력 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><date></date></nowiki>
| <date></date>
|-
! 입력값
! 출력값
|}

현재 날짜를 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

{| class="wikitable" style="text-align: center;"
| <nowiki><datetime></datetime></nowiki>
| <datetime></datetime>
|-
! 입력값
! 출력값
|}

현재 날짜와 시간값을 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

==== 서버 시간 표시 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><svrtime></svrtime></nowiki><br><nowiki><svrtime>Asia/Seoul</svrtime></nowiki><br><nowiki><svrtime>PHP</svrtime></nowiki><br><nowiki><svrtime>WIKI</svrtime></nowiki>
| <svrtime></svrtime><br><svrtime>Asia/Seoul</svrtime><br><svrtime>PHP</svrtime><br><svrtime>WIKI</svrtime>
|-
! 입력값
! 출력값
|}

서버 시간을 기준으로 현재 시간을 출력합니다.<ref>위의 <code><nowiki><datetime></datetime></nowiki></code>도 마찬가지로 서버 시간으로 현재 시간을 출력함</ref> 다만 <code><nowiki><datetime></datetime></nowiki></code>와 달리 시간대를 선택할 수 있습니다.

<svrtime></svrtime> → 현재 서버 시간 표시(시간대는 서버가 사용중인 시간대)
<svrtime>Asia/Seoul</svrtime> → 현재 서버 시간 표시(시간대는 Asia/Seoul)
<svrtime>PHP</svrtime> → 현재 서버 시간 표시(PHP 시간 정보, php는 대소문자 구분 안함)
<svrtime>WIKI</svrtime> → 현재 서버 시간 표시(위키의 시간대를 이용한 시간 표시, WIKI 대소문자 구분 안함)

=== 날짜 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc></nowiki><br><nowiki><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc></nowiki>
| <datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc><br><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc>
|-
! 입력값
! 출력값
|}

기준 날짜 또는 기준 날짜 및 시간을 입력 후 이후의 연월일 값을 입력하면 그 이후의 날짜를 출력합니다. 다만 태그 안에 값을 입력하지 않거나, 기준 날짜(및 시간)을 입력하지 않은 경우, 이후의 연원일 값을 입력하지 않으면 <code>Error: Invalid input</code>라고 출력이 됩니다.

기준 날짜(시간값을 지정하지 않은 경우)에 연월일 + 시간값을 더하면, 결과값은 KST 기준 현재 시간값으로 계산됩니다.

=== 만 나이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><age>1975-00-00</age></nowiki><br><nowiki><age>1975-07-00</age></nowiki><br><nowiki><age>1975-07-20</age></nowiki>
| <age>1975-00-00</age><br><age>1975-07-00</age><br><age>1975-07-20</age>
|-
! 입력값
! 출력값
|}

만 나이를 계산합니다. 기본적으로 생년월일을 입력하면 현재 날짜 기준으로 만나이를 계산하며, KST를 기준으로 합니다. 만약 연도와 달 또는 연도만 아는 경우, 나머지 모르는 부분에 00을 입력하면 대략적인 만나이를 출력합니다. 만약 태그 안에 값을 입력하지 않으면 <code>Error: No date value provided.</code>라고 출력되고, 날짜 포맷에 맞추어 입력하지 않으면 <code>Error: Date format is incorrect. Please use 'YYYY-MM-DD'.</code>라고 출력됩니다.

=== 디데이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><dday>2030-10-20</dday></nowiki>
| <dday>2030-10-20</dday>
|-
! 입력값
! 출력값
|}

현재 날짜를 기준으로 태그 안의 날짜까지 얼마나 남았는지 일수를 알려줍니다. 연도의 범위는 0부터 9999까지이며, 이 범위를 넘은 값을 입력하면 <code>Invalid year in date</code> 라는 메시지를 띄우도록 설계되어 있지만, <code>-8258 days 13 hours 0 minutes 37 seconds ago</code> 이렇게 출력이 될 수도 있습니다. PHP의 한계이므로 양해 부탁드립니다. 태그 안에 아무런 값을 입력하지 않으면 <code>No date provided in the tag.</code> 라고 출력됩니다.

=== 윤년 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><leapyear>2030-10-20</leapyear></nowiki>
| <leapyear>2030-10-20</leapyear>
|-
! 입력값
! 출력값
|}

연도 또는 날짜를 입력하면, 해당 연도가 윤년인지 여부를 출력합니다. 윤년인 경우 <code>True</code>를, 윤년이 아닌 경우 <code>False</code>를 반환합니다.

== 글자 ==
=== 요소 정렬 ===
'''입력값: ''' <nowiki><float val='left'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='left'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='center'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='center'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='tcenter'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='tcenter'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='right'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='right'>Hello, world!</float><br>

요소를 왼쪽, 중앙, 가운데로 정렬할 수 있습니다. 요소의 css 중 <code>float</code> 속성을 지정하며, <code>center는</code> <code>float</code>가 아닌 <code>margin: auto</code>로 설정합니다. <code>tcenter</code>는 <code>text center</code>의 뜻으로 <code>margin: auto</code> 뿐만 아니라 <code>text-align: auto</code> 까지 부여합니다.

=== 세로 쓰기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><vertical>안녕하세요, 가온이에요!</vertical></nowiki>
| <vertical>안녕하세요, 가온이에요!</vertical>
|-
! 입력값
! 출력값
|}

태그 안의 값을 세로로 위치시킵니다.

=== 요소 움직이기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase></nowiki>
| <mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase>
|-
! 입력값
! 출력값
|}

요소를 왼쪽 또는 오른쪽으로 움직이는 애니메이션 효과를 줄 수 있습니다. <code>direction</code> 속성에는 움직일 방향을 정의<ref><code>left</code> 또는 <code>right</code></ref>하고, <code>speed</code>에는 움직임 속도를 정의합니다. 각 속성의 기본값은 <code>left</code>와 <code>100</code>이며, 기본 움직임 속도가 매우 빠르기 때문에 속도값을 많이 줄이는 것을 권장합니다.

=== 글자 블러 처리 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><blur>안녕하세요, 가온이에요!</blur></nowiki>
| <blur>안녕하세요, 가온이에요!</blur>
|-
! 입력값
! 출력값
|}

글자를 블러 처리할 수 있습니다. 태그 안에 값을 입력하면 블러 처리가 되며, 내외부 링크 모두 동작합니다. 마우스로 블러 처리된 부분 위로 가져다 놓으면 블러가 잠깐 해제됩니다.

분류는 본 방식으로 블러 처리가 되지 않습니다. 분류에서의 블러 처리는 아래의 문단을 확인하시기 바랍니다.

==== 분류 블러 ====
{| class="wikitable" style="text-align: center;"
| <nowiki>[[분류:블러 처리 된 분류@@blur]]</nowiki>
| [[분류:블러 처리 된 분류@@blur]] 상단 분류값 확인
|-
! 입력값
! 출력값
|}

분류 중에 블러 처리를 하기 원하는 경우, 분류명 맨 뒤에 <code><nowiki>@@blur</nowiki></code>를 붙이면, 블러 처리가 됩니다. 단, 자바스크립트를 허용(기본적으로는 허용되어 있음)해야만 작동하며, 자바스크립트에서 처리하기 때문에 약간의 시간이 걸릴 수 있습니다.

=== 해시갑 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><hash type="sha256">안녕하세요</hash></nowiki>
| <hash type="sha256">안녕하세요</hash>
|-
! 입력값
! 출력값
|}

태그 안의 값을 <code>type</code> 속성으로 지정한 해시 방식으로 해시화 한 뒤 결과값을 출력합니다. PHP 버전 및 모듈에 따라 다르지만, 사용 가능한 방식은 <code>md2 / md4 / md5 / sha1 / sha224 / sha256 / sha384 / sha512/224 / sha512/256 / sha512 / sha3-224 / sha3-256 / sha3-384 / sha3-512 / ripemd128 / ripemd160 / ripemd256 / ripemd320 / whirlpool / tiger128,3 / tiger160,3 / tiger192,3 / tiger128,4 / tiger160,4 / tiger192,4 / snefru / snefru256 / gost / gost-crypto / adler32 / crc32 / crc32b / crc32c / fnv132 / fnv1a32 / fnv164 / fnv1a64 / joaat / haval128,3 / haval160,3 / haval192,3 / haval224,3 / haval256,3 / haval128,4 / haval160,4 / haval192,4 / haval224,4 / haval256,4 / haval128,5 / haval160,5 / haval192,5 / haval224,5 / haval256,5</code>가 있습니다.

=== 접기 펼치기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><folding>안녕하세요</folding></nowiki><br><nowiki><folding>제목||내용입니다</folding></nowiki>
| <folding>안녕하세요</folding><br><folding>제목||내용입니다</folding>
|-
! 입력값
! 출력값
|}

내용이 길어 접었다가 상세한 내용을 보기를 원하는 사용자가 클릭하면 숨겨진 내용이 나오도록 할 수 있습니다. 제목과 내용 부분은 <code>||</code>로 구분하며, 만약 구분하지 않고 내용만 입력하면 '''[접기 · 펼치기]''' 가 제목으로 나오게 됩니다.

=== 아스키 유니코드 변환 ===
==== 아스키 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><ascii type="str" to="10">h</ascii></nowiki>
| <ascii type="str" to="10">h</ascii>
|-
! 입력값
! 출력값
|}

아스키 코드를 변환합니다. <code><ascii type="{문자(str)/10진수(10)/16진수(16)}" to="{문자(str)/10진수(10)/16진수(16)}">값</ascii></code> 형태로 입력하며, 여러 값이 있더라도 맨 첫번째 값<ref>hello라고 입력하면 h</ref>만 계산됩니다.

==== 유니코드 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode></nowiki>
| <unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode>
|-
! 입력값
! 출력값
|}

유니코드를 변환합니다. 유니코드 값을 <code>U+XXXX</code> 형태로 입력하면 그 값을 반환합니다.

=== 문자열 길이 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><len>Pneumonoultramicroscopicsilicovolcanoconiosis</len></nowiki>
| <len>Pneumonoultramicroscopicsilicovolcanoconiosis</len>
|-
! 입력값
! 출력값
|}

문자열의 길이를 반환합니다. 띄어쓰기와 특수문자를 모두 반영합니다.

=== 문자열 갯수 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count></nowiki>
| <count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count>
|-
! 입력값
! 출력값
|}

원하는 문자열이 몇개 들어있는지를 반환합니다. 대소문자를 구분합니다.

=== 전부 대(소)문자로 변환 ===
==== 전부 대문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><upper>hello i am a boy!</upper></nowiki>
| <upper>hello i am a boy!</upper>
|-
! 입력값
! 출력값
|}

모든 글자를 대문자로 변환합니다.

==== 전부 소문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><lower>HELLO MR MY YESTERDAY</lower></nowiki>
| <lower>HELLO MR MY YESTERDAY</lower>
|-
! 입력값
! 출력값
|}

모든 글자를 소문자로 변환합니다.

=== 대(소)문자 여부 ===
==== 대문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><isupper>HELLO I AM A BOY!</isupper></nowiki>
| <isupper>HELLO I AM A BOY!</isupper>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 대문자인 경우 <code>True</code>를, 소문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

==== 소문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><islower>hello Mr my yesterday</islower></nowiki>
| <islower>hello Mr my yesterday</islower>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 소문자인 경우 <code>True</code>를, 대문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

=== 문자열 뒤집기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><reverse>Hello</reverse></nowiki>
| <reverse>Hello</reverse>
|-
! 입력값
! 출력값
|}

입력한 문자열을 뒤집어 출력합니다.

=== 공백 제거 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces></nowiki>
| <rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces>
|-
! 입력값
! 출력값
|}

공백을 제거합니다.

=== 정렬 ===
==== 오름차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-asc>Friendship</sort-asc></nowiki>
| <sort-asc>Friendship</sort-asc>
|-
! 입력값
! 출력값
|}

오름차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 대문자가 우선합니다.

==== 내림차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-desc>Friendship</sort-desc></nowiki>
| <sort-desc>Friendship</sort-desc>
|-
! 입력값
! 출력값
|}

내림차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 소문자가 우선합니다.

=== 글자 및 배경색 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><wordclr color="red" bg="yellow">Hello, world!</wordclr></nowiki>
| <wordclr color="red" bg="yellow">Hello, world!</wordclr>
|-
! 입력값
! 출력값
|}

글자 색과 배경색을 지정할 수 있습니다. <code>color</code>값을 지정하지 않으면 <code>black</code>으로, <code>bg</code>를 지정하지 않으면 투명(없음)으로 설정됩니다.

=== URL 인코딩 디코딩 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><urlencode>안녕하세요!</urlencode></nowiki><br><nowiki><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode></nowiki>
| <urlencode>안녕하세요!</urlencode><br><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode>
|-
! 입력값
! 출력값
|}

url 값을 인코딩 시키거나 디코딩 시켜서 반환합니다.

=== 마크다운 뱃지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mdbadge type='language' value='php'></mdbadge></nowiki>
| <mdbadge type='language' value='php'></mdbadge>
|-
! 입력값
! 출력값
|}

깃허브 등에서 마크다운으로 뱃지를 넣는 것을 보고 착안했습니다. 사용 가능한 <code>type</code>은 <code>'build', 'code Coverage', 'language', 'test Results', 'analysis', 'chat', 'dependencies', 'size', 'downloads', 'funding', 'issue_tracking', 'license', 'rating', 'social', 'version', 'platform', 'monitoring', 'activity', 'custom'</code>이 있으며, 각 <code>type</code>별로 색상이 다릅니다.

== 랜덤 ==
=== 퍼센트 별 출력 메시지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random></nowiki>
| <random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자로 값을 입력하면, 해당 확률에 따라 <code>True</code> 또는 <code>False</code> 여부를 확인 후, 사용자가 설정한 문구가 나오도록 합니다. 새로고침 할 때마다 확률을 다시 계산합니다.

=== 랜덤 뽑기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><draw range="1-15" count="5" duplication="true"></draw></nowiki>
| <draw range="1-15" count="5" duplication="true"></draw>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자 범위를 입력하고, <code>count</code>에는 몇 개를 뽑을 것인지 선택하면, 랜덤하게 숫자를 뽑아줍니다. <code>duplication</code> 옵션은 중복을 허용할 것인지 이며, 입력하지 않은 경우 중복을 허용하지 않습니다.

<code>range</code> 내의 숫자보다 <code>count</code>의 갯수가 적은 경우, 예를 들어 <code>range</code>가 <code>1~5</code>이고, <code>count</code>가 <code>10</code>이면, 5개만 나오게 됩니다.

마찬가지로 새로고침 할 때마다 새로 뽑습니다.

=== 랜덤 문자열 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rdstr sets="up,num" len="20"></rdstr></nowiki>
| <rdstr sets="up,num" len="20"></rdstr>
|-
! 입력값
! 출력값
|}

랜덤한 문자열을 생성합니다. <code>sets</code>에는 어떤 문자를 넣을 것인지, <code>len</code>은 글자 수를 설정하는 것이며, <code>sets</code>에는 <code>up</code><ref>대문자</ref>, <code>low</code><ref>소문자</ref>, <code>num</code><ref>숫자</ref> 중에서 1개 이상을 입력하면 됩니다. 마찬가지로 새로고침 할 때마다 새로 생성합니다.

== 기타 ==
=== Progress Bar 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar></nowiki>
|-
! 입력값
|-
| <progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar>
|-
! 출력값
|}

Progress Bar를 생성합니다. <code>percent</code>에는 progress bar의 퍼센테이지<ref>전체를 100%로 보았을 때의 퍼센테이지를 입력</ref>, <code>value</code>에는 바 안에 출력할 값을, <code>color</code>는 바의 색상, <code>width</code>는 가로 길이, <code>height</code>는 세로 길이를 정의합니다.

<code>percent</code>는 필수로 입력해야 하고, 나머지 요소들을 선택사항 입니다. <code>color</code>의 기본값은 <code>#00BCD4</code>이고 <code>width</code>의 기본값은 <code>100%</code>, <code>height</code>의 기본값은 <code>20px</code> 입니다.

=== 컬러 팔레트 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><colorpalette type="rgb">125,32,80</colorpalette></nowiki>
| <colorpalette type="rgb">125,32,80</colorpalette>
|-
! 입력값
! 출력값
|}

입력한 색상 값을 출력합니다. <code>type</code>에는 <code>rgb</code>, <code>hex</code>, <code>cmyk</code> 중 하나를 선택할 수 있으며, 입력하지 않는 경우 기본값은 <code>rgb</code> 입니다. 색상은 가로-세로 5em-1em 영역에 표시가 됩니다.

<code>rgb</code>는 <code>alpha</code> 채널도 지원합니다.

== 각주 ==


[[분류:문법 개선]]

2023 문법 개선 프로젝트

2023-06-05T08:33:35Z

Admin: /* 수평줄 */ 지원 종료

== 개요 ==
[[2023년 위키 개선 프로젝트]]의 일환으로서 기존의 부족한 위키 문법을 개선했습니다. 각 문법 별 사용 방법과 표시 결과를 출력합니다.

== 수학 ==
=== 최대값 최소값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max></nowiki><br><nowiki><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min></nowiki>
| <max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max><br><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min>
|-
! 입력값
! 출력값
|}

<code><nowiki><max></max></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 큰 값을 반환합니다. 반대로 <code><nowiki><min></min></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 작은 값을 반환합니다. 만약 <code><nowiki><max></max></nowiki></code> 태그나 <code><nowiki><min></min></nowiki></code> 태그 안에 아무것도 입력하지 않는다면 ''''"`UNIQ--max-00000013-QINU`"''''나 ''''"`UNIQ--min-00000013-QINU`"''''으로 출력되기 때문에 반드시 1개 이상 입력하시기 바랍니다.

=== 평균 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average></nowiki>
| <average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average>
|-
! 입력값
! 출력값
|}

<code><nowiki><average></average></nowiki></code> 태그 안에 있는 숫자들의 평균을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 중앙값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median></nowiki>
| <median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median>
|-
! 입력값
! 출력값
|}

<code><nowiki><median></median></nowiki></code> 태그 안에 있는 숫자들의 중앙값을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 최빈값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode></nowiki>
| <mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode>
|-
! 입력값
! 출력값
|}

<code><nowiki><mode></mode></nowiki></code> 태그 안에 있는 숫자들의 최빈값울 출력합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, 최빈값이 존재하지 않는 경우<ref>모두 1개씩만 있는 경우</ref>에는 모든 숫자들이 출력<ref>작은 숫자부터 큰 숫자로 정렬되어 출력</ref>이 됩니다.

=== 올림, 반올림, 버림 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><ceil>161.3</ceil></nowiki><br><nowiki><round>53.5</round></nowiki><br><nowiki><floor>23.9</floor></nowiki>
| <ceil>161.3</ceil><br><round>53.5</round><br><floor>23.9</floor>
|-
! 입력값
! 출력값
|}

소수점 아래의 숫자를 보고 '''올림/반올림/버림'''을 합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, '''","'''로 값을 여러개 입력하더라도 계산되어 출력되는 것은 맨 처음 입력된 값입니다.

=== 원주율 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><pi></pi></nowiki>
| <pi></pi>
|-
! 입력값
! 출력값
|}

원주율(<math>\pi</math>)을 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><pi>5</pi></code> 이렇게 입력하면 '''<pi>5</pi>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 로그 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><log2></log2></nowiki>
| <log2></log2>
|-
! 입력값
! 출력값
|}

로그 2(<math>log2</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><log2>5</log2></code> 이렇게 입력하면 '''<log2>5</log2>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 루트 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><sqrt2></sqrt2></nowiki>
| <sqrt2></sqrt2>
|-
! 입력값
! 출력값
|}

루트 2(<math>\sqrt{2}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><sqrt2>5</sqrt2></code> 이렇게 입력하면 '''<sqrt2>5</sqrt2> '''이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 자연로그 밑 e ===
{| class="wikitable" style="text-align: center;"
| <nowiki><euler></euler></nowiki>
| <euler></euler>
|-
! 입력값
! 출력값
|}

루트 2(<math>{e}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><euler>5</euler></code> 이렇게 입력하면 '''<euler>5</euler>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 수식 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mathcalc>2+3*sqrt(4)</mathcalc></nowiki>
| <mathcalc>2+3*sqrt(4)</mathcalc>
|-
! 입력값
! 출력값
|}

자바스크립트 Math.js 라이브러리로 계산한 값을 출력합니다. 서버에서 계산하지 않으므로 계산값이 출력되는데 약간의 시간이 걸리며, 자바스크립트를 사용하지 않는 매우매우 드문 유저는 사용할 수 없습니다.

== 날짜 ==
=== 현재 날짜 및 시간 출력 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><date></date></nowiki>
| <date></date>
|-
! 입력값
! 출력값
|}

현재 날짜를 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

{| class="wikitable" style="text-align: center;"
| <nowiki><datetime></datetime></nowiki>
| <datetime></datetime>
|-
! 입력값
! 출력값
|}

현재 날짜와 시간값을 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

==== 서버 시간 표시 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><svrtime></svrtime></nowiki><br><nowiki><svrtime>Asia/Seoul</svrtime></nowiki><br><nowiki><svrtime>PHP</svrtime></nowiki><br><nowiki><svrtime>WIKI</svrtime></nowiki>
| <svrtime></svrtime><br><svrtime>Asia/Seoul</svrtime><br><svrtime>PHP</svrtime><br><svrtime>WIKI</svrtime>
|-
! 입력값
! 출력값
|}

서버 시간을 기준으로 현재 시간을 출력합니다.<ref>위의 <code><nowiki><datetime></datetime></nowiki></code>도 마찬가지로 서버 시간으로 현재 시간을 출력함</ref> 다만 <code><nowiki><datetime></datetime></nowiki></code>와 달리 시간대를 선택할 수 있습니다.

<svrtime></svrtime> → 현재 서버 시간 표시(시간대는 서버가 사용중인 시간대)
<svrtime>Asia/Seoul</svrtime> → 현재 서버 시간 표시(시간대는 Asia/Seoul)
<svrtime>PHP</svrtime> → 현재 서버 시간 표시(PHP 시간 정보, php는 대소문자 구분 안함)
<svrtime>WIKI</svrtime> → 현재 서버 시간 표시(위키의 시간대를 이용한 시간 표시, WIKI 대소문자 구분 안함)

=== 날짜 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc></nowiki><br><nowiki><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc></nowiki>
| <datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc><br><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc>
|-
! 입력값
! 출력값
|}

기준 날짜 또는 기준 날짜 및 시간을 입력 후 이후의 연월일 값을 입력하면 그 이후의 날짜를 출력합니다. 다만 태그 안에 값을 입력하지 않거나, 기준 날짜(및 시간)을 입력하지 않은 경우, 이후의 연원일 값을 입력하지 않으면 <code>Error: Invalid input</code>라고 출력이 됩니다.

기준 날짜(시간값을 지정하지 않은 경우)에 연월일 + 시간값을 더하면, 결과값은 KST 기준 현재 시간값으로 계산됩니다.

=== 만 나이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><age>1975-00-00</age></nowiki><br><nowiki><age>1975-07-00</age></nowiki><br><nowiki><age>1975-07-20</age></nowiki>
| <age>1975-00-00</age><br><age>1975-07-00</age><br><age>1975-07-20</age>
|-
! 입력값
! 출력값
|}

만 나이를 계산합니다. 기본적으로 생년월일을 입력하면 현재 날짜 기준으로 만나이를 계산하며, KST를 기준으로 합니다. 만약 연도와 달 또는 연도만 아는 경우, 나머지 모르는 부분에 00을 입력하면 대략적인 만나이를 출력합니다. 만약 태그 안에 값을 입력하지 않으면 <code>Error: No date value provided.</code>라고 출력되고, 날짜 포맷에 맞추어 입력하지 않으면 <code>Error: Date format is incorrect. Please use 'YYYY-MM-DD'.</code>라고 출력됩니다.

=== 디데이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><dday>2030-10-20</dday></nowiki>
| <dday>2030-10-20</dday>
|-
! 입력값
! 출력값
|}

현재 날짜를 기준으로 태그 안의 날짜까지 얼마나 남았는지 일수를 알려줍니다. 연도의 범위는 0부터 9999까지이며, 이 범위를 넘은 값을 입력하면 <code>Invalid year in date</code> 라는 메시지를 띄우도록 설계되어 있지만, <code>-8258 days 13 hours 0 minutes 37 seconds ago</code> 이렇게 출력이 될 수도 있습니다. PHP의 한계이므로 양해 부탁드립니다. 태그 안에 아무런 값을 입력하지 않으면 <code>No date provided in the tag.</code> 라고 출력됩니다.

=== 윤년 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><leapyear>2030-10-20</leapyear></nowiki>
| <leapyear>2030-10-20</leapyear>
|-
! 입력값
! 출력값
|}

연도 또는 날짜를 입력하면, 해당 연도가 윤년인지 여부를 출력합니다. 윤년인 경우 <code>True</code>를, 윤년이 아닌 경우 <code>False</code>를 반환합니다.

== 글자 ==
=== 요소 정렬 ===
'''입력값: ''' <nowiki><float val='left'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='left'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='center'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='center'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='tcenter'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='tcenter'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='right'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='right'>Hello, world!</float><br>

요소를 왼쪽, 중앙, 가운데로 정렬할 수 있습니다. 요소의 css 중 <code>float</code> 속성을 지정하며, <code>center는</code> <code>float</code>가 아닌 <code>margin: auto</code>로 설정합니다. <code>tcenter</code>는 <code>text center</code>의 뜻으로 <code>margin: auto</code> 뿐만 아니라 <code>text-align: auto</code> 까지 부여합니다.

=== 세로 쓰기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><vertical>안녕하세요, 가온이에요!</vertical></nowiki>
| <vertical>안녕하세요, 가온이에요!</vertical>
|-
! 입력값
! 출력값
|}

태그 안의 값을 세로로 위치시킵니다.

=== 요소 움직이기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase></nowiki>
| <mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase>
|-
! 입력값
! 출력값
|}

요소를 왼쪽 또는 오른쪽으로 움직이는 애니메이션 효과를 줄 수 있습니다. <code>direction</code> 속성에는 움직일 방향을 정의<ref><code>left</code> 또는 <code>right</code></ref>하고, <code>speed</code>에는 움직임 속도를 정의합니다. 각 속성의 기본값은 <code>left</code>와 <code>100</code>이며, 기본 움직임 속도가 매우 빠르기 때문에 속도값을 많이 줄이는 것을 권장합니다.

=== 글자 블러 처리 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><blur>안녕하세요, 가온이에요!</blur></nowiki>
| <blur>안녕하세요, 가온이에요!</blur>
|-
! 입력값
! 출력값
|}

글자를 블러 처리할 수 있습니다. 태그 안에 값을 입력하면 블러 처리가 되며, 내외부 링크 모두 동작합니다. 마우스로 블러 처리된 부분 위로 가져다 놓으면 블러가 잠깐 해제됩니다.

분류는 본 방식으로 블러 처리가 되지 않습니다. 분류에서의 블러 처리는 아래의 문단을 확인하시기 바랍니다.

==== 분류 블러 ====
{| class="wikitable" style="text-align: center;"
| <nowiki>[[분류:블러 처리 된 분류@@blur]]</nowiki>
| [[분류:블러 처리 된 분류@@blur]] 상단 분류값 확인
|-
! 입력값
! 출력값
|}

분류 중에 블러 처리를 하기 원하는 경우, 분류명 맨 뒤에 <code><nowiki>@@blur</nowiki></code>를 붙이면, 블러 처리가 됩니다. 단, 자바스크립트를 허용(기본적으로는 허용되어 있음)해야만 작동하며, 자바스크립트에서 처리하기 때문에 약간의 시간이 걸릴 수 있습니다.

=== 해시갑 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><hash type="sha256">안녕하세요</hash></nowiki>
| <hash type="sha256">안녕하세요</hash>
|-
! 입력값
! 출력값
|}

태그 안의 값을 <code>type</code> 속성으로 지정한 해시 방식으로 해시화 한 뒤 결과값을 출력합니다. PHP 버전 및 모듈에 따라 다르지만, 사용 가능한 방식은 <code>md2 / md4 / md5 / sha1 / sha224 / sha256 / sha384 / sha512/224 / sha512/256 / sha512 / sha3-224 / sha3-256 / sha3-384 / sha3-512 / ripemd128 / ripemd160 / ripemd256 / ripemd320 / whirlpool / tiger128,3 / tiger160,3 / tiger192,3 / tiger128,4 / tiger160,4 / tiger192,4 / snefru / snefru256 / gost / gost-crypto / adler32 / crc32 / crc32b / crc32c / fnv132 / fnv1a32 / fnv164 / fnv1a64 / joaat / haval128,3 / haval160,3 / haval192,3 / haval224,3 / haval256,3 / haval128,4 / haval160,4 / haval192,4 / haval224,4 / haval256,4 / haval128,5 / haval160,5 / haval192,5 / haval224,5 / haval256,5</code>가 있습니다.

=== 접기 펼치기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><folding>안녕하세요</folding></nowiki><br><nowiki><folding>제목||내용입니다</folding></nowiki>
| <folding>안녕하세요</folding><br><folding>제목||내용입니다</folding>
|-
! 입력값
! 출력값
|}

내용이 길어 접었다가 상세한 내용을 보기를 원하는 사용자가 클릭하면 숨겨진 내용이 나오도록 할 수 있습니다. 제목과 내용 부분은 <code>||</code>로 구분하며, 만약 구분하지 않고 내용만 입력하면 '''[접기 · 펼치기]''' 가 제목으로 나오게 됩니다.

=== 아스키 유니코드 변환 ===
==== 아스키 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><ascii type="str" to="10">h</ascii></nowiki>
| <ascii type="str" to="10">h</ascii>
|-
! 입력값
! 출력값
|}

아스키 코드를 변환합니다. <code><ascii type="{문자(str)/10진수(10)/16진수(16)}" to="{문자(str)/10진수(10)/16진수(16)}">값</ascii></code> 형태로 입력하며, 여러 값이 있더라도 맨 첫번째 값<ref>hello라고 입력하면 h</ref>만 계산됩니다.

==== 유니코드 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode></nowiki>
| <unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode>
|-
! 입력값
! 출력값
|}

유니코드를 변환합니다. 유니코드 값을 <code>U+XXXX</code> 형태로 입력하면 그 값을 반환합니다.

=== 문자열 길이 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><len>Pneumonoultramicroscopicsilicovolcanoconiosis</len></nowiki>
| <len>Pneumonoultramicroscopicsilicovolcanoconiosis</len>
|-
! 입력값
! 출력값
|}

문자열의 길이를 반환합니다. 띄어쓰기와 특수문자를 모두 반영합니다.

=== 문자열 갯수 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count></nowiki>
| <count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count>
|-
! 입력값
! 출력값
|}

원하는 문자열이 몇개 들어있는지를 반환합니다. 대소문자를 구분합니다.

=== 전부 대(소)문자로 변환 ===
==== 전부 대문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><upper>hello i am a boy!</upper></nowiki>
| <upper>hello i am a boy!</upper>
|-
! 입력값
! 출력값
|}

모든 글자를 대문자로 변환합니다.

==== 전부 소문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><lower>HELLO MR MY YESTERDAY</lower></nowiki>
| <lower>HELLO MR MY YESTERDAY</lower>
|-
! 입력값
! 출력값
|}

모든 글자를 소문자로 변환합니다.

=== 대(소)문자 여부 ===
==== 대문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><isupper>HELLO I AM A BOY!</isupper></nowiki>
| <isupper>HELLO I AM A BOY!</isupper>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 대문자인 경우 <code>True</code>를, 소문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

==== 소문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><islower>hello Mr my yesterday</islower></nowiki>
| <islower>hello Mr my yesterday</islower>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 소문자인 경우 <code>True</code>를, 대문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

=== 문자열 뒤집기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><reverse>Hello</reverse></nowiki>
| <reverse>Hello</reverse>
|-
! 입력값
! 출력값
|}

입력한 문자열을 뒤집어 출력합니다.

=== 공백 제거 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces></nowiki>
| <rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces>
|-
! 입력값
! 출력값
|}

공백을 제거합니다.

=== 정렬 ===
==== 오름차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-asc>Friendship</sort-asc></nowiki>
| <sort-asc>Friendship</sort-asc>
|-
! 입력값
! 출력값
|}

오름차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 대문자가 우선합니다.

==== 내림차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-desc>Friendship</sort-desc></nowiki>
| <sort-desc>Friendship</sort-desc>
|-
! 입력값
! 출력값
|}

내림차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 소문자가 우선합니다.

=== 글자 및 배경색 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><wordclr color="red" bg="yellow">Hello, world!</wordclr></nowiki>
| <wordclr color="red" bg="yellow">Hello, world!</wordclr>
|-
! 입력값
! 출력값
|}

글자 색과 배경색을 지정할 수 있습니다. <code>color</code>값을 지정하지 않으면 <code>black</code>으로, <code>bg</code>를 지정하지 않으면 투명(없음)으로 설정됩니다.

=== URL 인코딩 디코딩 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><urlencode>안녕하세요!</urlencode></nowiki><br><nowiki><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode></nowiki>
| <urlencode>안녕하세요!</urlencode><br><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode>
|-
! 입력값
! 출력값
|}

url 값을 인코딩 시키거나 디코딩 시켜서 반환합니다.

=== 마크다운 뱃지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mdbadge type='language' value='php'></mdbadge></nowiki>
| <mdbadge type='language' value='php'></mdbadge>
|-
! 입력값
! 출력값
|}

깃허브 등에서 마크다운으로 뱃지를 넣는 것을 보고 착안했습니다. 사용 가능한 <code>type</code>은 <code>'build', 'code Coverage', 'language', 'test Results', 'analysis', 'chat', 'dependencies', 'size', 'downloads', 'funding', 'issue_tracking', 'license', 'rating', 'social', 'version', 'platform', 'monitoring', 'activity', 'custom'</code>이 있으며, 각 <code>type</code>별로 색상이 다릅니다.

== 랜덤 ==
=== 퍼센트 별 출력 메시지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random></nowiki>
| <random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자로 값을 입력하면, 해당 확률에 따라 <code>True</code> 또는 <code>False</code> 여부를 확인 후, 사용자가 설정한 문구가 나오도록 합니다. 새로고침 할 때마다 확률을 다시 계산합니다.

=== 랜덤 뽑기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><draw range="1-15" count="5" duplication="true"></draw></nowiki>
| <draw range="1-15" count="5" duplication="true"></draw>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자 범위를 입력하고, <code>count</code>에는 몇 개를 뽑을 것인지 선택하면, 랜덤하게 숫자를 뽑아줍니다. <code>duplication</code> 옵션은 중복을 허용할 것인지 이며, 입력하지 않은 경우 중복을 허용하지 않습니다.

<code>range</code> 내의 숫자보다 <code>count</code>의 갯수가 적은 경우, 예를 들어 <code>range</code>가 <code>1~5</code>이고, <code>count</code>가 <code>10</code>이면, 5개만 나오게 됩니다.

마찬가지로 새로고침 할 때마다 새로 뽑습니다.

=== 랜덤 문자열 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rdstr sets="up,num" len="20"></rdstr></nowiki>
| <rdstr sets="up,num" len="20"></rdstr>
|-
! 입력값
! 출력값
|}

랜덤한 문자열을 생성합니다. <code>sets</code>에는 어떤 문자를 넣을 것인지, <code>len</code>은 글자 수를 설정하는 것이며, <code>sets</code>에는 <code>up</code><ref>대문자</ref>, <code>low</code><ref>소문자</ref>, <code>num</code><ref>숫자</ref> 중에서 1개 이상을 입력하면 됩니다. 마찬가지로 새로고침 할 때마다 새로 생성합니다.

== 기타 ==
=== Progress Bar 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar></nowiki>
|-
! 입력값
|-
| <progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar>
|-
! 출력값
|}

Progress Bar를 생성합니다. <code>percent</code>에는 progress bar의 퍼센테이지<ref>전체를 100%로 보았을 때의 퍼센테이지를 입력</ref>, <code>value</code>에는 바 안에 출력할 값을, <code>color</code>는 바의 색상, <code>width</code>는 가로 길이, <code>height</code>는 세로 길이를 정의합니다.

<code>percent</code>는 필수로 입력해야 하고, 나머지 요소들을 선택사항 입니다. <code>color</code>의 기본값은 <code>#00BCD4</code>이고 <code>width</code>의 기본값은 <code>100%</code>, <code>height</code>의 기본값은 <code>20px</code> 입니다.

=== 컬러 팔레트 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><colorpalette type="rgb">125,32,80</colorpalette></nowiki>
| <colorpalette type="rgb">125,32,80</colorpalette>
|-
! 입력값
! 출력값
|}

입력한 색상 값을 출력합니다. <code>type</code>에는 <code>rgb</code>, <code>hex</code>, <code>cmyk</code> 중 하나를 선택할 수 있으며, 입력하지 않는 경우 기본값은 <code>rgb</code> 입니다. 색상은 가로-세로 5em-1em 영역에 표시가 됩니다.

<code>rgb</code>는 <code>alpha</code> 채널도 지원합니다.

== 각주 ==


[[분류:문법 개선]]

2023 문법 개선 프로젝트

2023-06-05T02:06:28Z

Admin: /* 최빈값 */ 입력값과 출력값이 다른 점 수정

== 개요 ==
[[2023년 위키 개선 프로젝트]]의 일환으로서 기존의 부족한 위키 문법을 개선했습니다. 각 문법 별 사용 방법과 표시 결과를 출력합니다.

== 수학 ==
=== 최대값 최소값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max></nowiki><br><nowiki><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min></nowiki>
| <max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max><br><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min>
|-
! 입력값
! 출력값
|}

<code><nowiki><max></max></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 큰 값을 반환합니다. 반대로 <code><nowiki><min></min></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 작은 값을 반환합니다. 만약 <code><nowiki><max></max></nowiki></code> 태그나 <code><nowiki><min></min></nowiki></code> 태그 안에 아무것도 입력하지 않는다면 ''''"`UNIQ--max-00000013-QINU`"''''나 ''''"`UNIQ--min-00000013-QINU`"''''으로 출력되기 때문에 반드시 1개 이상 입력하시기 바랍니다.

=== 평균 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average></nowiki>
| <average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average>
|-
! 입력값
! 출력값
|}

<code><nowiki><average></average></nowiki></code> 태그 안에 있는 숫자들의 평균을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 중앙값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median></nowiki>
| <median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median>
|-
! 입력값
! 출력값
|}

<code><nowiki><median></median></nowiki></code> 태그 안에 있는 숫자들의 중앙값을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 최빈값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode></nowiki>
| <mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode>
|-
! 입력값
! 출력값
|}

<code><nowiki><mode></mode></nowiki></code> 태그 안에 있는 숫자들의 최빈값울 출력합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, 최빈값이 존재하지 않는 경우<ref>모두 1개씩만 있는 경우</ref>에는 모든 숫자들이 출력<ref>작은 숫자부터 큰 숫자로 정렬되어 출력</ref>이 됩니다.

=== 올림, 반올림, 버림 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><ceil>161.3</ceil></nowiki><br><nowiki><round>53.5</round></nowiki><br><nowiki><floor>23.9</floor></nowiki>
| <ceil>161.3</ceil><br><round>53.5</round><br><floor>23.9</floor>
|-
! 입력값
! 출력값
|}

소수점 아래의 숫자를 보고 '''올림/반올림/버림'''을 합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, '''","'''로 값을 여러개 입력하더라도 계산되어 출력되는 것은 맨 처음 입력된 값입니다.

=== 원주율 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><pi></pi></nowiki>
| <pi></pi>
|-
! 입력값
! 출력값
|}

원주율(<math>\pi</math>)을 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><pi>5</pi></code> 이렇게 입력하면 '''<pi>5</pi>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 로그 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><log2></log2></nowiki>
| <log2></log2>
|-
! 입력값
! 출력값
|}

로그 2(<math>log2</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><log2>5</log2></code> 이렇게 입력하면 '''<log2>5</log2>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 루트 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><sqrt2></sqrt2></nowiki>
| <sqrt2></sqrt2>
|-
! 입력값
! 출력값
|}

루트 2(<math>\sqrt{2}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><sqrt2>5</sqrt2></code> 이렇게 입력하면 '''<sqrt2>5</sqrt2> '''이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 자연로그 밑 e ===
{| class="wikitable" style="text-align: center;"
| <nowiki><euler></euler></nowiki>
| <euler></euler>
|-
! 입력값
! 출력값
|}

루트 2(<math>{e}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><euler>5</euler></code> 이렇게 입력하면 '''<euler>5</euler>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 수식 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mathcalc>2+3*sqrt(4)</mathcalc></nowiki>
| <mathcalc>2+3*sqrt(4)</mathcalc>
|-
! 입력값
! 출력값
|}

자바스크립트 Math.js 라이브러리로 계산한 값을 출력합니다. 서버에서 계산하지 않으므로 계산값이 출력되는데 약간의 시간이 걸리며, 자바스크립트를 사용하지 않는 매우매우 드문 유저는 사용할 수 없습니다.

== 날짜 ==
=== 현재 날짜 및 시간 출력 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><date></date></nowiki>
| <date></date>
|-
! 입력값
! 출력값
|}

현재 날짜를 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

{| class="wikitable" style="text-align: center;"
| <nowiki><datetime></datetime></nowiki>
| <datetime></datetime>
|-
! 입력값
! 출력값
|}

현재 날짜와 시간값을 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

==== 서버 시간 표시 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><svrtime></svrtime></nowiki><br><nowiki><svrtime>Asia/Seoul</svrtime></nowiki><br><nowiki><svrtime>PHP</svrtime></nowiki><br><nowiki><svrtime>WIKI</svrtime></nowiki>
| <svrtime></svrtime><br><svrtime>Asia/Seoul</svrtime><br><svrtime>PHP</svrtime><br><svrtime>WIKI</svrtime>
|-
! 입력값
! 출력값
|}

서버 시간을 기준으로 현재 시간을 출력합니다.<ref>위의 <code><nowiki><datetime></datetime></nowiki></code>도 마찬가지로 서버 시간으로 현재 시간을 출력함</ref> 다만 <code><nowiki><datetime></datetime></nowiki></code>와 달리 시간대를 선택할 수 있습니다.

<svrtime></svrtime> → 현재 서버 시간 표시(시간대는 서버가 사용중인 시간대)
<svrtime>Asia/Seoul</svrtime> → 현재 서버 시간 표시(시간대는 Asia/Seoul)
<svrtime>PHP</svrtime> → 현재 서버 시간 표시(PHP 시간 정보, php는 대소문자 구분 안함)
<svrtime>WIKI</svrtime> → 현재 서버 시간 표시(위키의 시간대를 이용한 시간 표시, WIKI 대소문자 구분 안함)

=== 날짜 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc></nowiki><br><nowiki><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc></nowiki>
| <datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc><br><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc>
|-
! 입력값
! 출력값
|}

기준 날짜 또는 기준 날짜 및 시간을 입력 후 이후의 연월일 값을 입력하면 그 이후의 날짜를 출력합니다. 다만 태그 안에 값을 입력하지 않거나, 기준 날짜(및 시간)을 입력하지 않은 경우, 이후의 연원일 값을 입력하지 않으면 <code>Error: Invalid input</code>라고 출력이 됩니다.

기준 날짜(시간값을 지정하지 않은 경우)에 연월일 + 시간값을 더하면, 결과값은 KST 기준 현재 시간값으로 계산됩니다.

=== 만 나이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><age>1975-00-00</age></nowiki><br><nowiki><age>1975-07-00</age></nowiki><br><nowiki><age>1975-07-20</age></nowiki>
| <age>1975-00-00</age><br><age>1975-07-00</age><br><age>1975-07-20</age>
|-
! 입력값
! 출력값
|}

만 나이를 계산합니다. 기본적으로 생년월일을 입력하면 현재 날짜 기준으로 만나이를 계산하며, KST를 기준으로 합니다. 만약 연도와 달 또는 연도만 아는 경우, 나머지 모르는 부분에 00을 입력하면 대략적인 만나이를 출력합니다. 만약 태그 안에 값을 입력하지 않으면 <code>Error: No date value provided.</code>라고 출력되고, 날짜 포맷에 맞추어 입력하지 않으면 <code>Error: Date format is incorrect. Please use 'YYYY-MM-DD'.</code>라고 출력됩니다.

=== 디데이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><dday>2030-10-20</dday></nowiki>
| <dday>2030-10-20</dday>
|-
! 입력값
! 출력값
|}

현재 날짜를 기준으로 태그 안의 날짜까지 얼마나 남았는지 일수를 알려줍니다. 연도의 범위는 0부터 9999까지이며, 이 범위를 넘은 값을 입력하면 <code>Invalid year in date</code> 라는 메시지를 띄우도록 설계되어 있지만, <code>-8258 days 13 hours 0 minutes 37 seconds ago</code> 이렇게 출력이 될 수도 있습니다. PHP의 한계이므로 양해 부탁드립니다. 태그 안에 아무런 값을 입력하지 않으면 <code>No date provided in the tag.</code> 라고 출력됩니다.

=== 윤년 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><leapyear>2030-10-20</leapyear></nowiki>
| <leapyear>2030-10-20</leapyear>
|-
! 입력값
! 출력값
|}

연도 또는 날짜를 입력하면, 해당 연도가 윤년인지 여부를 출력합니다. 윤년인 경우 <code>True</code>를, 윤년이 아닌 경우 <code>False</code>를 반환합니다.

== 글자 ==
=== 요소 정렬 ===
'''입력값: ''' <nowiki><float val='left'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='left'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='center'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='center'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='tcenter'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='tcenter'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='right'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='right'>Hello, world!</float><br>

요소를 왼쪽, 중앙, 가운데로 정렬할 수 있습니다. 요소의 css 중 <code>float</code> 속성을 지정하며, <code>center는</code> <code>float</code>가 아닌 <code>margin: auto</code>로 설정합니다. <code>tcenter</code>는 <code>text center</code>의 뜻으로 <code>margin: auto</code> 뿐만 아니라 <code>text-align: auto</code> 까지 부여합니다.

=== 세로 쓰기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><vertical>안녕하세요, 가온이에요!</vertical></nowiki>
| <vertical>안녕하세요, 가온이에요!</vertical>
|-
! 입력값
! 출력값
|}

태그 안의 값을 세로로 위치시킵니다.

=== 요소 움직이기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase></nowiki>
| <mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase>
|-
! 입력값
! 출력값
|}

요소를 왼쪽 또는 오른쪽으로 움직이는 애니메이션 효과를 줄 수 있습니다. <code>direction</code> 속성에는 움직일 방향을 정의<ref><code>left</code> 또는 <code>right</code></ref>하고, <code>speed</code>에는 움직임 속도를 정의합니다. 각 속성의 기본값은 <code>left</code>와 <code>100</code>이며, 기본 움직임 속도가 매우 빠르기 때문에 속도값을 많이 줄이는 것을 권장합니다.

=== 글자 블러 처리 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><blur>안녕하세요, 가온이에요!</blur></nowiki>
| <blur>안녕하세요, 가온이에요!</blur>
|-
! 입력값
! 출력값
|}

글자를 블러 처리할 수 있습니다. 태그 안에 값을 입력하면 블러 처리가 되며, 내외부 링크 모두 동작합니다. 마우스로 블러 처리된 부분 위로 가져다 놓으면 블러가 잠깐 해제됩니다.

분류는 본 방식으로 블러 처리가 되지 않습니다. 분류에서의 블러 처리는 아래의 문단을 확인하시기 바랍니다.

==== 분류 블러 ====
{| class="wikitable" style="text-align: center;"
| <nowiki>[[분류:블러 처리 된 분류@@blur]]</nowiki>
| [[분류:블러 처리 된 분류@@blur]] 상단 분류값 확인
|-
! 입력값
! 출력값
|}

분류 중에 블러 처리를 하기 원하는 경우, 분류명 맨 뒤에 <code><nowiki>@@blur</nowiki></code>를 붙이면, 블러 처리가 됩니다. 단, 자바스크립트를 허용(기본적으로는 허용되어 있음)해야만 작동하며, 자바스크립트에서 처리하기 때문에 약간의 시간이 걸릴 수 있습니다.

=== 해시갑 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><hash type="sha256">안녕하세요</hash></nowiki>
| <hash type="sha256">안녕하세요</hash>
|-
! 입력값
! 출력값
|}

태그 안의 값을 <code>type</code> 속성으로 지정한 해시 방식으로 해시화 한 뒤 결과값을 출력합니다. PHP 버전 및 모듈에 따라 다르지만, 사용 가능한 방식은 <code>md2 / md4 / md5 / sha1 / sha224 / sha256 / sha384 / sha512/224 / sha512/256 / sha512 / sha3-224 / sha3-256 / sha3-384 / sha3-512 / ripemd128 / ripemd160 / ripemd256 / ripemd320 / whirlpool / tiger128,3 / tiger160,3 / tiger192,3 / tiger128,4 / tiger160,4 / tiger192,4 / snefru / snefru256 / gost / gost-crypto / adler32 / crc32 / crc32b / crc32c / fnv132 / fnv1a32 / fnv164 / fnv1a64 / joaat / haval128,3 / haval160,3 / haval192,3 / haval224,3 / haval256,3 / haval128,4 / haval160,4 / haval192,4 / haval224,4 / haval256,4 / haval128,5 / haval160,5 / haval192,5 / haval224,5 / haval256,5</code>가 있습니다.

=== 접기 펼치기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><folding>안녕하세요</folding></nowiki><br><nowiki><folding>제목||내용입니다</folding></nowiki>
| <folding>안녕하세요</folding><br><folding>제목||내용입니다</folding>
|-
! 입력값
! 출력값
|}

내용이 길어 접었다가 상세한 내용을 보기를 원하는 사용자가 클릭하면 숨겨진 내용이 나오도록 할 수 있습니다. 제목과 내용 부분은 <code>||</code>로 구분하며, 만약 구분하지 않고 내용만 입력하면 '''[접기 · 펼치기]''' 가 제목으로 나오게 됩니다.

=== 아스키 유니코드 변환 ===
==== 아스키 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><ascii type="str" to="10">h</ascii></nowiki>
| <ascii type="str" to="10">h</ascii>
|-
! 입력값
! 출력값
|}

아스키 코드를 변환합니다. <code><ascii type="{문자(str)/10진수(10)/16진수(16)}" to="{문자(str)/10진수(10)/16진수(16)}">값</ascii></code> 형태로 입력하며, 여러 값이 있더라도 맨 첫번째 값<ref>hello라고 입력하면 h</ref>만 계산됩니다.

==== 유니코드 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode></nowiki>
| <unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode>
|-
! 입력값
! 출력값
|}

유니코드를 변환합니다. 유니코드 값을 <code>U+XXXX</code> 형태로 입력하면 그 값을 반환합니다.

=== 문자열 길이 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><len>Pneumonoultramicroscopicsilicovolcanoconiosis</len></nowiki>
| <len>Pneumonoultramicroscopicsilicovolcanoconiosis</len>
|-
! 입력값
! 출력값
|}

문자열의 길이를 반환합니다. 띄어쓰기와 특수문자를 모두 반영합니다.

=== 문자열 갯수 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count></nowiki>
| <count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count>
|-
! 입력값
! 출력값
|}

원하는 문자열이 몇개 들어있는지를 반환합니다. 대소문자를 구분합니다.

=== 전부 대(소)문자로 변환 ===
==== 전부 대문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><upper>hello i am a boy!</upper></nowiki>
| <upper>hello i am a boy!</upper>
|-
! 입력값
! 출력값
|}

모든 글자를 대문자로 변환합니다.

==== 전부 소문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><lower>HELLO MR MY YESTERDAY</lower></nowiki>
| <lower>HELLO MR MY YESTERDAY</lower>
|-
! 입력값
! 출력값
|}

모든 글자를 소문자로 변환합니다.

=== 대(소)문자 여부 ===
==== 대문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><isupper>HELLO I AM A BOY!</isupper></nowiki>
| <isupper>HELLO I AM A BOY!</isupper>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 대문자인 경우 <code>True</code>를, 소문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

==== 소문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><islower>hello Mr my yesterday</islower></nowiki>
| <islower>hello Mr my yesterday</islower>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 소문자인 경우 <code>True</code>를, 대문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

=== 문자열 뒤집기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><reverse>Hello</reverse></nowiki>
| <reverse>Hello</reverse>
|-
! 입력값
! 출력값
|}

입력한 문자열을 뒤집어 출력합니다.

=== 공백 제거 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces></nowiki>
| <rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces>
|-
! 입력값
! 출력값
|}

공백을 제거합니다.

=== 정렬 ===
==== 오름차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-asc>Friendship</sort-asc></nowiki>
| <sort-asc>Friendship</sort-asc>
|-
! 입력값
! 출력값
|}

오름차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 대문자가 우선합니다.

==== 내림차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-desc>Friendship</sort-desc></nowiki>
| <sort-desc>Friendship</sort-desc>
|-
! 입력값
! 출력값
|}

내림차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 소문자가 우선합니다.

=== 글자 및 배경색 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><wordclr color="red" bg="yellow">Hello, world!</wordclr></nowiki>
| <wordclr color="red" bg="yellow">Hello, world!</wordclr>
|-
! 입력값
! 출력값
|}

글자 색과 배경색을 지정할 수 있습니다. <code>color</code>값을 지정하지 않으면 <code>black</code>으로, <code>bg</code>를 지정하지 않으면 투명(없음)으로 설정됩니다.

=== 수평줄 ===
'''입력값: '''<code><nowiki>-----</nowiki></code><br>
'''출력값: '''
-----

<code>-</code>을 4개 이상 입력하면 수평줄이 생깁니다. 단, 단독으로 사용해야 하며 앞에 공백 등이 있으면 작동하지 않습니다.

=== URL 인코딩 디코딩 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><urlencode>안녕하세요!</urlencode></nowiki><br><nowiki><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode></nowiki>
| <urlencode>안녕하세요!</urlencode><br><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode>
|-
! 입력값
! 출력값
|}

url 값을 인코딩 시키거나 디코딩 시켜서 반환합니다.

=== 마크다운 뱃지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mdbadge type='language' value='php'></mdbadge></nowiki>
| <mdbadge type='language' value='php'></mdbadge>
|-
! 입력값
! 출력값
|}

깃허브 등에서 마크다운으로 뱃지를 넣는 것을 보고 착안했습니다. 사용 가능한 <code>type</code>은 <code>'build', 'code Coverage', 'language', 'test Results', 'analysis', 'chat', 'dependencies', 'size', 'downloads', 'funding', 'issue_tracking', 'license', 'rating', 'social', 'version', 'platform', 'monitoring', 'activity', 'custom'</code>이 있으며, 각 <code>type</code>별로 색상이 다릅니다.

== 랜덤 ==
=== 퍼센트 별 출력 메시지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random></nowiki>
| <random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자로 값을 입력하면, 해당 확률에 따라 <code>True</code> 또는 <code>False</code> 여부를 확인 후, 사용자가 설정한 문구가 나오도록 합니다. 새로고침 할 때마다 확률을 다시 계산합니다.

=== 랜덤 뽑기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><draw range="1-15" count="5" duplication="true"></draw></nowiki>
| <draw range="1-15" count="5" duplication="true"></draw>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자 범위를 입력하고, <code>count</code>에는 몇 개를 뽑을 것인지 선택하면, 랜덤하게 숫자를 뽑아줍니다. <code>duplication</code> 옵션은 중복을 허용할 것인지 이며, 입력하지 않은 경우 중복을 허용하지 않습니다.

<code>range</code> 내의 숫자보다 <code>count</code>의 갯수가 적은 경우, 예를 들어 <code>range</code>가 <code>1~5</code>이고, <code>count</code>가 <code>10</code>이면, 5개만 나오게 됩니다.

마찬가지로 새로고침 할 때마다 새로 뽑습니다.

=== 랜덤 문자열 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rdstr sets="up,num" len="20"></rdstr></nowiki>
| <rdstr sets="up,num" len="20"></rdstr>
|-
! 입력값
! 출력값
|}

랜덤한 문자열을 생성합니다. <code>sets</code>에는 어떤 문자를 넣을 것인지, <code>len</code>은 글자 수를 설정하는 것이며, <code>sets</code>에는 <code>up</code><ref>대문자</ref>, <code>low</code><ref>소문자</ref>, <code>num</code><ref>숫자</ref> 중에서 1개 이상을 입력하면 됩니다. 마찬가지로 새로고침 할 때마다 새로 생성합니다.

== 기타 ==
=== Progress Bar 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar></nowiki>
|-
! 입력값
|-
| <progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar>
|-
! 출력값
|}

Progress Bar를 생성합니다. <code>percent</code>에는 progress bar의 퍼센테이지<ref>전체를 100%로 보았을 때의 퍼센테이지를 입력</ref>, <code>value</code>에는 바 안에 출력할 값을, <code>color</code>는 바의 색상, <code>width</code>는 가로 길이, <code>height</code>는 세로 길이를 정의합니다.

<code>percent</code>는 필수로 입력해야 하고, 나머지 요소들을 선택사항 입니다. <code>color</code>의 기본값은 <code>#00BCD4</code>이고 <code>width</code>의 기본값은 <code>100%</code>, <code>height</code>의 기본값은 <code>20px</code> 입니다.

=== 컬러 팔레트 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><colorpalette type="rgb">125,32,80</colorpalette></nowiki>
| <colorpalette type="rgb">125,32,80</colorpalette>
|-
! 입력값
! 출력값
|}

입력한 색상 값을 출력합니다. <code>type</code>에는 <code>rgb</code>, <code>hex</code>, <code>cmyk</code> 중 하나를 선택할 수 있으며, 입력하지 않는 경우 기본값은 <code>rgb</code> 입니다. 색상은 가로-세로 5em-1em 영역에 표시가 됩니다.

<code>rgb</code>는 <code>alpha</code> 채널도 지원합니다.

== 각주 ==


[[분류:문법 개선]]

가온 위키:대문

2023-06-02T08:08:14Z

Admin: 문법 개선 지원

<div style="border-top: 10px solid #00BCD4; padding: 3px; box-shadow: 3px 3px 13px #B3B3B3; text-align: center; border-radius:10px;>
<div>
<big>모두의 <s>마블</s>, 가온 위키!<br><br></big>

<p style="margin-top: -20px; font-size: 25px;>[[가온 위키]]에 오신 것을<br>환영합니다!</p>
</div>
<big>[[가온 위키]]는 누구든 참여 할 수 있는 위키 입니다!</big>
</div>

<br>

<hr />

<div id="notice" style="border: solid #e1e8ed; padding: 25px;">
{| class="mw-collapsible" style="margin: auto;"
| align="center" | <big><big><big><big>공지사항<br><br></big></big></big></big>
|-
| <br>1. 단축 URL 생성, 코드 공유 서비스 임베드를 할 수 있어요. [https://bbs.gaonwiki.com/notice/4702 공지 게시글]에서 더욱 자세히 알아보세요!
|-
| <br>2. 위키의 부족한 문법을 개선했어요. [https://bbs.gaonwiki.com/notice/4711 공지]와 [[2023 문법 개선 프로젝트|사용법]] 을 확인해 보세요!
|-
| <br>3. 스크롤 프로그래스 바를 스킨에서 분리해 확장기능으로 동작하도록 했습니다.
|-
| <br>민방위, 지진 대피소 위치 정보를 추가해 봅시다! 공공데이터포털에서 대피소 정보에서 ''''이용허락범위 제한 없음''''으로 된 정보와, 각 지자체 사이트의 정보를 활용합시다. '''국민재난안전포털은 공공누리 4유형이므로 피하고, 공공누리 저작물 사용 시, 1유형만 사용'''하도록 해주시기 바랍니다.
|-
| align="center" | <hr /> 자세한 내용은<br> [https://bbs.gaonwiki.com/notice 공지사항 게시판]을 확인해 주세요!
|}
</div>

2023 문법 개선 프로젝트

2023-06-01T05:00:19Z

Admin: 시작

== 개요 ==
[[2023년 위키 개선 프로젝트]]의 일환으로서 기존의 부족한 위키 문법을 개선했습니다. 각 문법 별 사용 방법과 표시 결과를 출력합니다.

== 수학 ==
=== 최대값 최소값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max></nowiki><br><nowiki><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min></nowiki>
| <max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max><br><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min>
|-
! 입력값
! 출력값
|}

<code><nowiki><max></max></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 큰 값을 반환합니다. 반대로 <code><nowiki><min></min></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 작은 값을 반환합니다. 만약 <code><nowiki><max></max></nowiki></code> 태그나 <code><nowiki><min></min></nowiki></code> 태그 안에 아무것도 입력하지 않는다면 ''''"`UNIQ--max-00000013-QINU`"''''나 ''''"`UNIQ--min-00000013-QINU`"''''으로 출력되기 때문에 반드시 1개 이상 입력하시기 바랍니다.

=== 평균 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average></nowiki>
| <average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average>
|-
! 입력값
! 출력값
|}

<code><nowiki><average></average></nowiki></code> 태그 안에 있는 숫자들의 평균을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 중앙값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median></nowiki>
| <median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median>
|-
! 입력값
! 출력값
|}

<code><nowiki><median></median></nowiki></code> 태그 안에 있는 숫자들의 중앙값을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 최빈값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</mode></nowiki>
| <mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode>
|-
! 입력값
! 출력값
|}

<code><nowiki><mode></mode></nowiki></code> 태그 안에 있는 숫자들의 최빈값울 출력합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, 최빈값이 존재하지 않는 경우<ref>모두 1개씩만 있는 경우</ref>에는 모든 숫자들이 출력<ref>작은 숫자부터 큰 숫자로 정렬되어 출력</ref>이 됩니다.

=== 올림, 반올림, 버림 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><ceil>161.3</ceil></nowiki><br><nowiki><round>53.5</round></nowiki><br><nowiki><floor>23.9</floor></nowiki>
| <ceil>161.3</ceil><br><round>53.5</round><br><floor>23.9</floor>
|-
! 입력값
! 출력값
|}

소수점 아래의 숫자를 보고 '''올림/반올림/버림'''을 합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, '''","'''로 값을 여러개 입력하더라도 계산되어 출력되는 것은 맨 처음 입력된 값입니다.

=== 원주율 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><pi></pi></nowiki>
| <pi></pi>
|-
! 입력값
! 출력값
|}

원주율(<math>\pi</math>)을 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><pi>5</pi></code> 이렇게 입력하면 '''<pi>5</pi>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 로그 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><log2></log2></nowiki>
| <log2></log2>
|-
! 입력값
! 출력값
|}

로그 2(<math>log2</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><log2>5</log2></code> 이렇게 입력하면 '''<log2>5</log2>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 루트 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><sqrt2></sqrt2></nowiki>
| <sqrt2></sqrt2>
|-
! 입력값
! 출력값
|}

루트 2(<math>\sqrt{2}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><sqrt2>5</sqrt2></code> 이렇게 입력하면 '''<sqrt2>5</sqrt2> '''이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 자연로그 밑 e ===
{| class="wikitable" style="text-align: center;"
| <nowiki><euler></euler></nowiki>
| <euler></euler>
|-
! 입력값
! 출력값
|}

루트 2(<math>{e}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><euler>5</euler></code> 이렇게 입력하면 '''<euler>5</euler>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 수식 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mathcalc>2+3*sqrt(4)</mathcalc></nowiki>
| <mathcalc>2+3*sqrt(4)</mathcalc>
|-
! 입력값
! 출력값
|}

자바스크립트 Math.js 라이브러리로 계산한 값을 출력합니다. 서버에서 계산하지 않으므로 계산값이 출력되는데 약간의 시간이 걸리며, 자바스크립트를 사용하지 않는 매우매우 드문 유저는 사용할 수 없습니다.

== 날짜 ==
=== 현재 날짜 및 시간 출력 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><date></date></nowiki>
| <date></date>
|-
! 입력값
! 출력값
|}

현재 날짜를 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

{| class="wikitable" style="text-align: center;"
| <nowiki><datetime></datetime></nowiki>
| <datetime></datetime>
|-
! 입력값
! 출력값
|}

현재 날짜와 시간값을 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

==== 서버 시간 표시 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><svrtime></svrtime></nowiki><br><nowiki><svrtime>Asia/Seoul</svrtime></nowiki><br><nowiki><svrtime>PHP</svrtime></nowiki><br><nowiki><svrtime>WIKI</svrtime></nowiki>
| <svrtime></svrtime><br><svrtime>Asia/Seoul</svrtime><br><svrtime>PHP</svrtime><br><svrtime>WIKI</svrtime>
|-
! 입력값
! 출력값
|}

서버 시간을 기준으로 현재 시간을 출력합니다.<ref>위의 <code><nowiki><datetime></datetime></nowiki></code>도 마찬가지로 서버 시간으로 현재 시간을 출력함</ref> 다만 <code><nowiki><datetime></datetime></nowiki></code>와 달리 시간대를 선택할 수 있습니다.

<svrtime></svrtime> → 현재 서버 시간 표시(시간대는 서버가 사용중인 시간대)
<svrtime>Asia/Seoul</svrtime> → 현재 서버 시간 표시(시간대는 Asia/Seoul)
<svrtime>PHP</svrtime> → 현재 서버 시간 표시(PHP 시간 정보, php는 대소문자 구분 안함)
<svrtime>WIKI</svrtime> → 현재 서버 시간 표시(위키의 시간대를 이용한 시간 표시, WIKI 대소문자 구분 안함)

=== 날짜 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc></nowiki><br><nowiki><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc></nowiki>
| <datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc><br><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc>
|-
! 입력값
! 출력값
|}

기준 날짜 또는 기준 날짜 및 시간을 입력 후 이후의 연월일 값을 입력하면 그 이후의 날짜를 출력합니다. 다만 태그 안에 값을 입력하지 않거나, 기준 날짜(및 시간)을 입력하지 않은 경우, 이후의 연원일 값을 입력하지 않으면 <code>Error: Invalid input</code>라고 출력이 됩니다.

기준 날짜(시간값을 지정하지 않은 경우)에 연월일 + 시간값을 더하면, 결과값은 KST 기준 현재 시간값으로 계산됩니다.

=== 만 나이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><age>1975-00-00</age></nowiki><br><nowiki><age>1975-07-00</age></nowiki><br><nowiki><age>1975-07-20</age></nowiki>
| <age>1975-00-00</age><br><age>1975-07-00</age><br><age>1975-07-20</age>
|-
! 입력값
! 출력값
|}

만 나이를 계산합니다. 기본적으로 생년월일을 입력하면 현재 날짜 기준으로 만나이를 계산하며, KST를 기준으로 합니다. 만약 연도와 달 또는 연도만 아는 경우, 나머지 모르는 부분에 00을 입력하면 대략적인 만나이를 출력합니다. 만약 태그 안에 값을 입력하지 않으면 <code>Error: No date value provided.</code>라고 출력되고, 날짜 포맷에 맞추어 입력하지 않으면 <code>Error: Date format is incorrect. Please use 'YYYY-MM-DD'.</code>라고 출력됩니다.

=== 디데이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><dday>2030-10-20</dday></nowiki>
| <dday>2030-10-20</dday>
|-
! 입력값
! 출력값
|}

현재 날짜를 기준으로 태그 안의 날짜까지 얼마나 남았는지 일수를 알려줍니다. 연도의 범위는 0부터 9999까지이며, 이 범위를 넘은 값을 입력하면 <code>Invalid year in date</code> 라는 메시지를 띄우도록 설계되어 있지만, <code>-8258 days 13 hours 0 minutes 37 seconds ago</code> 이렇게 출력이 될 수도 있습니다. PHP의 한계이므로 양해 부탁드립니다. 태그 안에 아무런 값을 입력하지 않으면 <code>No date provided in the tag.</code> 라고 출력됩니다.

=== 윤년 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><leapyear>2030-10-20</leapyear></nowiki>
| <leapyear>2030-10-20</leapyear>
|-
! 입력값
! 출력값
|}

연도 또는 날짜를 입력하면, 해당 연도가 윤년인지 여부를 출력합니다. 윤년인 경우 <code>True</code>를, 윤년이 아닌 경우 <code>False</code>를 반환합니다.

== 글자 ==
=== 요소 정렬 ===
'''입력값: ''' <nowiki><float val='left'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='left'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='center'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='center'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='tcenter'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='tcenter'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='right'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='right'>Hello, world!</float><br>

요소를 왼쪽, 중앙, 가운데로 정렬할 수 있습니다. 요소의 css 중 <code>float</code> 속성을 지정하며, <code>center는</code> <code>float</code>가 아닌 <code>margin: auto</code>로 설정합니다. <code>tcenter</code>는 <code>text center</code>의 뜻으로 <code>margin: auto</code> 뿐만 아니라 <code>text-align: auto</code> 까지 부여합니다.

=== 세로 쓰기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><vertical>안녕하세요, 가온이에요!</vertical></nowiki>
| <vertical>안녕하세요, 가온이에요!</vertical>
|-
! 입력값
! 출력값
|}

태그 안의 값을 세로로 위치시킵니다.

=== 요소 움직이기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase></nowiki>
| <mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase>
|-
! 입력값
! 출력값
|}

요소를 왼쪽 또는 오른쪽으로 움직이는 애니메이션 효과를 줄 수 있습니다. <code>direction</code> 속성에는 움직일 방향을 정의<ref><code>left</code> 또는 <code>right</code></ref>하고, <code>speed</code>에는 움직임 속도를 정의합니다. 각 속성의 기본값은 <code>left</code>와 <code>100</code>이며, 기본 움직임 속도가 매우 빠르기 때문에 속도값을 많이 줄이는 것을 권장합니다.

=== 글자 블러 처리 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><blur>안녕하세요, 가온이에요!</blur></nowiki>
| <blur>안녕하세요, 가온이에요!</blur>
|-
! 입력값
! 출력값
|}

글자를 블러 처리할 수 있습니다. 태그 안에 값을 입력하면 블러 처리가 되며, 내외부 링크 모두 동작합니다. 마우스로 블러 처리된 부분 위로 가져다 놓으면 블러가 잠깐 해제됩니다.

분류는 본 방식으로 블러 처리가 되지 않습니다. 분류에서의 블러 처리는 아래의 문단을 확인하시기 바랍니다.

==== 분류 블러 ====
{| class="wikitable" style="text-align: center;"
| <nowiki>[[분류:블러 처리 된 분류@@blur]]</nowiki>
| [[분류:블러 처리 된 분류@@blur]] 상단 분류값 확인
|-
! 입력값
! 출력값
|}

분류 중에 블러 처리를 하기 원하는 경우, 분류명 맨 뒤에 <code><nowiki>@@blur</nowiki></code>를 붙이면, 블러 처리가 됩니다. 단, 자바스크립트를 허용(기본적으로는 허용되어 있음)해야만 작동하며, 자바스크립트에서 처리하기 때문에 약간의 시간이 걸릴 수 있습니다.

=== 해시갑 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><hash type="sha256">안녕하세요</hash></nowiki>
| <hash type="sha256">안녕하세요</hash>
|-
! 입력값
! 출력값
|}

태그 안의 값을 <code>type</code> 속성으로 지정한 해시 방식으로 해시화 한 뒤 결과값을 출력합니다. PHP 버전 및 모듈에 따라 다르지만, 사용 가능한 방식은 <code>md2 / md4 / md5 / sha1 / sha224 / sha256 / sha384 / sha512/224 / sha512/256 / sha512 / sha3-224 / sha3-256 / sha3-384 / sha3-512 / ripemd128 / ripemd160 / ripemd256 / ripemd320 / whirlpool / tiger128,3 / tiger160,3 / tiger192,3 / tiger128,4 / tiger160,4 / tiger192,4 / snefru / snefru256 / gost / gost-crypto / adler32 / crc32 / crc32b / crc32c / fnv132 / fnv1a32 / fnv164 / fnv1a64 / joaat / haval128,3 / haval160,3 / haval192,3 / haval224,3 / haval256,3 / haval128,4 / haval160,4 / haval192,4 / haval224,4 / haval256,4 / haval128,5 / haval160,5 / haval192,5 / haval224,5 / haval256,5</code>가 있습니다.

=== 접기 펼치기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><folding>안녕하세요</folding></nowiki><br><nowiki><folding>제목||내용입니다</folding></nowiki>
| <folding>안녕하세요</folding><br><folding>제목||내용입니다</folding>
|-
! 입력값
! 출력값
|}

내용이 길어 접었다가 상세한 내용을 보기를 원하는 사용자가 클릭하면 숨겨진 내용이 나오도록 할 수 있습니다. 제목과 내용 부분은 <code>||</code>로 구분하며, 만약 구분하지 않고 내용만 입력하면 '''[접기 · 펼치기]''' 가 제목으로 나오게 됩니다.

=== 아스키 유니코드 변환 ===
==== 아스키 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><ascii type="str" to="10">h</ascii></nowiki>
| <ascii type="str" to="10">h</ascii>
|-
! 입력값
! 출력값
|}

아스키 코드를 변환합니다. <code><ascii type="{문자(str)/10진수(10)/16진수(16)}" to="{문자(str)/10진수(10)/16진수(16)}">값</ascii></code> 형태로 입력하며, 여러 값이 있더라도 맨 첫번째 값<ref>hello라고 입력하면 h</ref>만 계산됩니다.

==== 유니코드 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode></nowiki>
| <unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode>
|-
! 입력값
! 출력값
|}

유니코드를 변환합니다. 유니코드 값을 <code>U+XXXX</code> 형태로 입력하면 그 값을 반환합니다.

=== 문자열 길이 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><len>Pneumonoultramicroscopicsilicovolcanoconiosis</len></nowiki>
| <len>Pneumonoultramicroscopicsilicovolcanoconiosis</len>
|-
! 입력값
! 출력값
|}

문자열의 길이를 반환합니다. 띄어쓰기와 특수문자를 모두 반영합니다.

=== 문자열 갯수 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count></nowiki>
| <count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count>
|-
! 입력값
! 출력값
|}

원하는 문자열이 몇개 들어있는지를 반환합니다. 대소문자를 구분합니다.

=== 전부 대(소)문자로 변환 ===
==== 전부 대문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><upper>hello i am a boy!</upper></nowiki>
| <upper>hello i am a boy!</upper>
|-
! 입력값
! 출력값
|}

모든 글자를 대문자로 변환합니다.

==== 전부 소문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><lower>HELLO MR MY YESTERDAY</lower></nowiki>
| <lower>HELLO MR MY YESTERDAY</lower>
|-
! 입력값
! 출력값
|}

모든 글자를 소문자로 변환합니다.

=== 대(소)문자 여부 ===
==== 대문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><isupper>HELLO I AM A BOY!</isupper></nowiki>
| <isupper>HELLO I AM A BOY!</isupper>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 대문자인 경우 <code>True</code>를, 소문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

==== 소문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><islower>hello Mr my yesterday</islower></nowiki>
| <islower>hello Mr my yesterday</islower>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 소문자인 경우 <code>True</code>를, 대문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

=== 문자열 뒤집기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><reverse>Hello</reverse></nowiki>
| <reverse>Hello</reverse>
|-
! 입력값
! 출력값
|}

입력한 문자열을 뒤집어 출력합니다.

=== 공백 제거 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces></nowiki>
| <rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces>
|-
! 입력값
! 출력값
|}

공백을 제거합니다.

=== 정렬 ===
==== 오름차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-asc>Friendship</sort-asc></nowiki>
| <sort-asc>Friendship</sort-asc>
|-
! 입력값
! 출력값
|}

오름차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 대문자가 우선합니다.

==== 내림차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-desc>Friendship</sort-desc></nowiki>
| <sort-desc>Friendship</sort-desc>
|-
! 입력값
! 출력값
|}

내림차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 소문자가 우선합니다.

=== 글자 및 배경색 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><wordclr color="red" bg="yellow">Hello, world!</wordclr></nowiki>
| <wordclr color="red" bg="yellow">Hello, world!</wordclr>
|-
! 입력값
! 출력값
|}

글자 색과 배경색을 지정할 수 있습니다. <code>color</code>값을 지정하지 않으면 <code>black</code>으로, <code>bg</code>를 지정하지 않으면 투명(없음)으로 설정됩니다.

=== 수평줄 ===
'''입력값: '''<code><nowiki>-----</nowiki></code><br>
'''출력값: '''
-----

<code>-</code>을 4개 이상 입력하면 수평줄이 생깁니다. 단, 단독으로 사용해야 하며 앞에 공백 등이 있으면 작동하지 않습니다.

=== URL 인코딩 디코딩 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><urlencode>안녕하세요!</urlencode></nowiki><br><nowiki><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode></nowiki>
| <urlencode>안녕하세요!</urlencode><br><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode>
|-
! 입력값
! 출력값
|}

url 값을 인코딩 시키거나 디코딩 시켜서 반환합니다.

=== 마크다운 뱃지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mdbadge type='language' value='php'></mdbadge></nowiki>
| <mdbadge type='language' value='php'></mdbadge>
|-
! 입력값
! 출력값
|}

깃허브 등에서 마크다운으로 뱃지를 넣는 것을 보고 착안했습니다. 사용 가능한 <code>type</code>은 <code>'build', 'code Coverage', 'language', 'test Results', 'analysis', 'chat', 'dependencies', 'size', 'downloads', 'funding', 'issue_tracking', 'license', 'rating', 'social', 'version', 'platform', 'monitoring', 'activity', 'custom'</code>이 있으며, 각 <code>type</code>별로 색상이 다릅니다.

== 랜덤 ==
=== 퍼센트 별 출력 메시지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random></nowiki>
| <random range="50">True시 이 문장을 보입니다.|False시 이 문장을 보입니다.</random>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자로 값을 입력하면, 해당 확률에 따라 <code>True</code> 또는 <code>False</code> 여부를 확인 후, 사용자가 설정한 문구가 나오도록 합니다. 새로고침 할 때마다 확률을 다시 계산합니다.

=== 랜덤 뽑기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><draw range="1-15" count="5" duplication="true"></draw></nowiki>
| <draw range="1-15" count="5" duplication="true"></draw>
|-
! 입력값
! 출력값
|}

<code>range</code> 안에 숫자 범위를 입력하고, <code>count</code>에는 몇 개를 뽑을 것인지 선택하면, 랜덤하게 숫자를 뽑아줍니다. <code>duplication</code> 옵션은 중복을 허용할 것인지 이며, 입력하지 않은 경우 중복을 허용하지 않습니다.

<code>range</code> 내의 숫자보다 <code>count</code>의 갯수가 적은 경우, 예를 들어 <code>range</code>가 <code>1~5</code>이고, <code>count</code>가 <code>10</code>이면, 5개만 나오게 됩니다.

마찬가지로 새로고침 할 때마다 새로 뽑습니다.

=== 랜덤 문자열 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rdstr sets="up,num" len="20"></rdstr></nowiki>
| <rdstr sets="up,num" len="20"></rdstr>
|-
! 입력값
! 출력값
|}

랜덤한 문자열을 생성합니다. <code>sets</code>에는 어떤 문자를 넣을 것인지, <code>len</code>은 글자 수를 설정하는 것이며, <code>sets</code>에는 <code>up</code><ref>대문자</ref>, <code>low</code><ref>소문자</ref>, <code>num</code><ref>숫자</ref> 중에서 1개 이상을 입력하면 됩니다. 마찬가지로 새로고침 할 때마다 새로 생성합니다.

== 기타 ==
=== Progress Bar 생성 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar></nowiki>
|-
! 입력값
|-
| <progress_bar percent="78" value="78퍼센트" color="#00BCD4" width="100%" height="20px"></progress_bar>
|-
! 출력값
|}

Progress Bar를 생성합니다. <code>percent</code>에는 progress bar의 퍼센테이지<ref>전체를 100%로 보았을 때의 퍼센테이지를 입력</ref>, <code>value</code>에는 바 안에 출력할 값을, <code>color</code>는 바의 색상, <code>width</code>는 가로 길이, <code>height</code>는 세로 길이를 정의합니다.

<code>percent</code>는 필수로 입력해야 하고, 나머지 요소들을 선택사항 입니다. <code>color</code>의 기본값은 <code>#00BCD4</code>이고 <code>width</code>의 기본값은 <code>100%</code>, <code>height</code>의 기본값은 <code>20px</code> 입니다.

=== 컬러 팔레트 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><colorpalette type="rgb">125,32,80</colorpalette></nowiki>
| <colorpalette type="rgb">125,32,80</colorpalette>
|-
! 입력값
! 출력값
|}

입력한 색상 값을 출력합니다. <code>type</code>에는 <code>rgb</code>, <code>hex</code>, <code>cmyk</code> 중 하나를 선택할 수 있으며, 입력하지 않는 경우 기본값은 <code>rgb</code> 입니다. 색상은 가로-세로 5em-1em 영역에 표시가 됩니다.

<code>rgb</code>는 <code>alpha</code> 채널도 지원합니다.

== 각주 ==


[[분류:문법 개선]]

2023 문법 개선 프로젝트

2023-06-01T04:26:04Z

Admin: 새 문서: == 개요 == 2023년 위키 개선 프로젝트의 일환으로서 기존의 부족한 위키 문법을 개선했습니다. 각 문법 별 사용 방법과 표시 결과를 출력합니다. == 수학 == === 최대값 최소값 === {| class="wikitable" style="text-align: center;" | <nowiki><max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max></nowiki><br><nowiki><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min></nowiki> | <max>161, 257, 168, 95, 315, 12, 215, 232,...

== 개요 ==
[[2023년 위키 개선 프로젝트]]의 일환으로서 기존의 부족한 위키 문법을 개선했습니다. 각 문법 별 사용 방법과 표시 결과를 출력합니다.

== 수학 ==
=== 최대값 최소값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max></nowiki><br><nowiki><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min></nowiki>
| <max>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</max><br><min>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</min>
|-
! 입력값
! 출력값
|}

<code><nowiki><max></max></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 큰 값을 반환합니다. 반대로 <code><nowiki><min></min></nowiki></code> 태그는 태그 안에 있는 숫자들 중에서 가장 작은 값을 반환합니다. 만약 <code><nowiki><max></max></nowiki></code> 태그나 <code><nowiki><min></min></nowiki></code> 태그 안에 아무것도 입력하지 않는다면 ''''"`UNIQ--max-00000013-QINU`"''''나 ''''"`UNIQ--min-00000013-QINU`"''''으로 출력되기 때문에 반드시 1개 이상 입력하시기 바랍니다.

=== 평균 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average></nowiki>
| <average>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</average>
|-
! 입력값
! 출력값
|}

<code><nowiki><average></average></nowiki></code> 태그 안에 있는 숫자들의 평균을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 중앙값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median></nowiki>
| <median>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</median>
|-
! 입력값
! 출력값
|}

<code><nowiki><median></median></nowiki></code> 태그 안에 있는 숫자들의 중앙값을 출력합니다. 만약 아무 값도 입력하지 않으면 '''0'''을 출력합니다.

=== 최빈값 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23</mode></nowiki>
| <mode>161, 257, 168, 95, 315, 12, 215, 232, 211, 23, 23, 12, 95, 12, 23</mode>
|-
! 입력값
! 출력값
|}

<code><nowiki><mode></mode></nowiki></code> 태그 안에 있는 숫자들의 최빈값울 출력합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, 최빈값이 존재하지 않는 경우<ref>모두 1개씩만 있는 경우</ref>에는 모든 숫자들이 출력<ref>작은 숫자부터 큰 숫자로 정렬되어 출력</ref>이 됩니다.

=== 올림, 반올림, 버림 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><ceil>161.3</ceil></nowiki><br><nowiki><round>53.5</round></nowiki><br><nowiki><floor>23.9</floor></nowiki>
| <ceil>161.3</ceil><br><round>53.5</round><br><floor>23.9</floor>
|-
! 입력값
! 출력값
|}

소수점 아래의 숫자를 보고 '''올림/반올림/버림'''을 합니다. 만약 아무 값도 입력하지 않으면 아무것도 출력되지 않으며, '''","'''로 값을 여러개 입력하더라도 계산되어 출력되는 것은 맨 처음 입력된 값입니다.

=== 원주율 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><pi></pi></nowiki>
| <pi></pi>
|-
! 입력값
! 출력값
|}

원주율(<math>\pi</math>)을 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><pi>5</pi></code> 이렇게 입력하면 '''<pi>5</pi>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 로그 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><log2></log2></nowiki>
| <log2></log2>
|-
! 입력값
! 출력값
|}

로그 2(<math>log2</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><log2>5</log2></code> 이렇게 입력하면 '''<log2>5</log2>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 루트 2 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><sqrt2></sqrt2></nowiki>
| <sqrt2></sqrt2>
|-
! 입력값
! 출력값
|}

루트 2(<math>\sqrt{2}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><sqrt2>5</sqrt2></code> 이렇게 입력하면 '''<sqrt2>5</sqrt2> '''이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 자연로그 밑 e ===
{| class="wikitable" style="text-align: center;"
| <nowiki><euler></euler></nowiki>
| <euler></euler>
|-
! 입력값
! 출력값
|}

루트 2(<math>{e}</math>)를 출력합니다. PHP로 원주율을 계산한 값을 출력하며, 태그 안에 숫자를 입력하여 자리수를 조절할 수 있습니다. 최대 14자리까지 표시 가능하며, 만약 5자리까지 표시를 원한다면 <code><euler>5</euler></code> 이렇게 입력하면 '''<euler>5</euler>''' 이렇게 출력이 됩니다. 자리수 미지정 시 14자리 까지 출력합니다.

=== 수식 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mathcalc>2+3*sqrt(4)</mathcalc></nowiki>
| <mathcalc>2+3*sqrt(4)</mathcalc>
|-
! 입력값
! 출력값
|}

자바스크립트 Math.js 라이브러리로 계산한 값을 출력합니다. 서버에서 계산하지 않으므로 계산값이 출력되는데 약간의 시간이 걸리며, 자바스크립트를 사용하지 않는 매우매우 드문 유저는 사용할 수 없습니다.

== 날짜 ==
=== 현재 날짜 및 시간 출력 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><date></date></nowiki>
| <date></date>
|-
! 입력값
! 출력값
|}

현재 날짜를 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

{| class="wikitable" style="text-align: center;"
| <nowiki><datetime></datetime></nowiki>
| <datetime></datetime>
|-
! 입력값
! 출력값
|}

현재 날짜와 시간값을 출력합니다. 현재 날짜는 문서를 볼때마다 최신화 됩니다.

==== 서버 시간 표시 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><svrtime></svrtime></nowiki><br><nowiki><svrtime>Asia/Seoul</svrtime></nowiki><br><nowiki><svrtime>PHP</svrtime></nowiki><br><nowiki><svrtime>WIKI</svrtime></nowiki>
| <svrtime></svrtime><br><svrtime>Asia/Seoul</svrtime><br><svrtime>PHP</svrtime><br><svrtime>WIKI</svrtime>
|-
! 입력값
! 출력값
|}

서버 시간을 기준으로 현재 시간을 출력합니다.<ref>위의 <code><nowiki><datetime></datetime></nowiki></code>도 마찬가지로 서버 시간으로 현재 시간을 출력함</ref> 다만 <code><nowiki><datetime></datetime></nowiki></code>와 달리 시간대를 선택할 수 있습니다.

<svrtime></svrtime> → 현재 서버 시간 표시(시간대는 서버가 사용중인 시간대)
<svrtime>Asia/Seoul</svrtime> → 현재 서버 시간 표시(시간대는 Asia/Seoul)
<svrtime>PHP</svrtime> → 현재 서버 시간 표시(PHP 시간 정보, php는 대소문자 구분 안함)
<svrtime>WIKI</svrtime> → 현재 서버 시간 표시(위키의 시간대를 이용한 시간 표시, WIKI 대소문자 구분 안함)

=== 날짜 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc></nowiki><br><nowiki><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc></nowiki>
| <datecalc>2023-10-05 + 1 year 5 months 31 days</datecalc><br><datecalc>2023-10-05 15:30:00 + 1 year 5 months 31 days 5 hours 10 minutes 30 seconds</datecalc>
|-
! 입력값
! 출력값
|}

기준 날짜 또는 기준 날짜 및 시간을 입력 후 이후의 연월일 값을 입력하면 그 이후의 날짜를 출력합니다. 다만 태그 안에 값을 입력하지 않거나, 기준 날짜(및 시간)을 입력하지 않은 경우, 이후의 연원일 값을 입력하지 않으면 <code>Error: Invalid input</code>라고 출력이 됩니다.

기준 날짜(시간값을 지정하지 않은 경우)에 연월일 + 시간값을 더하면, 결과값은 KST 기준 현재 시간값으로 계산됩니다.

=== 만 나이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><age>1975-00-00</age></nowiki><br><nowiki><age>1975-07-00</age></nowiki><br><nowiki><age>1975-07-20</age></nowiki>
| <age>1975-00-00</age><br><age>1975-07-00</age><br><age>1975-07-20</age>
|-
! 입력값
! 출력값
|}

만 나이를 계산합니다. 기본적으로 생년월일을 입력하면 현재 날짜 기준으로 만나이를 계산하며, KST를 기준으로 합니다. 만약 연도와 달 또는 연도만 아는 경우, 나머지 모르는 부분에 00을 입력하면 대략적인 만나이를 출력합니다. 만약 태그 안에 값을 입력하지 않으면 <code>Error: No date value provided.</code>라고 출력되고, 날짜 포맷에 맞추어 입력하지 않으면 <code>Error: Date format is incorrect. Please use 'YYYY-MM-DD'.</code>라고 출력됩니다.

=== 디데이 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><dday>2030-10-20</dday></nowiki>
| <dday>2030-10-20</dday>
|-
! 입력값
! 출력값
|}

현재 날짜를 기준으로 태그 안의 날짜까지 얼마나 남았는지 일수를 알려줍니다. 연도의 범위는 0부터 9999까지이며, 이 범위를 넘은 값을 입력하면 <code>Invalid year in date</code> 라는 메시지를 띄우도록 설계되어 있지만, <code>-8258 days 13 hours 0 minutes 37 seconds ago</code> 이렇게 출력이 될 수도 있습니다. PHP의 한계이므로 양해 부탁드립니다. 태그 안에 아무런 값을 입력하지 않으면 <code>No date provided in the tag.</code> 라고 출력됩니다.

=== 윤년 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><leapyear>2030-10-20</leapyear></nowiki>
| <leapyear>2030-10-20</leapyear>
|-
! 입력값
! 출력값
|}

연도 또는 날짜를 입력하면, 해당 연도가 윤년인지 여부를 출력합니다. 윤년인 경우 <code>True</code>를, 윤년이 아닌 경우 <code>False</code>를 반환합니다.

== 글자 ==
=== 요소 정렬 ===
'''입력값: ''' <nowiki><float val='left'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='left'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='center'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='center'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='tcenter'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='tcenter'>Hello, world!</float><br>
'''입력값: ''' <nowiki><float val='right'>Hello, world!</float></nowiki> / '''"출력값: '''<float val='right'>Hello, world!</float><br>

요소를 왼쪽, 중앙, 가운데로 정렬할 수 있습니다. 요소의 css 중 <code>float</code> 속성을 지정하며, <code>center는</code> <code>float</code>가 아닌 <code>margin: auto</code>로 설정합니다. <code>tcenter</code>는 <code>text center</code>의 뜻으로 <code>margin: auto</code> 뿐만 아니라 <code>text-align: auto</code> 까지 부여합니다.

=== 세로 쓰기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><vertical>안녕하세요, 가온이에요!</vertical></nowiki>
| <vertical>안녕하세요, 가온이에요!</vertical>
|-
! 입력값
! 출력값
|}

태그 안의 값을 세로로 위치시킵니다.

=== 요소 움직이기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase></nowiki>
| <mvphrase direction='right' speed='30'>안녕하세요, 가온이에요!</mvphrase>
|-
! 입력값
! 출력값
|}

요소를 왼쪽 또는 오른쪽으로 움직이는 애니메이션 효과를 줄 수 있습니다. <code>direction</code> 속성에는 움직일 방향을 정의<ref><code>left</code> 또는 <code>right</code></ref>하고, <code>speed</code>에는 움직임 속도를 정의합니다. 각 속성의 기본값은 <code>left</code>와 <code>100</code>이며, 기본 움직임 속도가 매우 빠르기 때문에 속도값을 많이 줄이는 것을 권장합니다.

=== 글자 블러 처리 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><blur>안녕하세요, 가온이에요!</blur></nowiki>
| <blur>안녕하세요, 가온이에요!</blur>
|-
! 입력값
! 출력값
|}

글자를 블러 처리할 수 있습니다. 태그 안에 값을 입력하면 블러 처리가 되며, 내외부 링크 모두 동작합니다. 마우스로 블러 처리된 부분 위로 가져다 놓으면 블러가 잠깐 해제됩니다.

분류는 본 방식으로 블러 처리가 되지 않습니다. 분류에서의 블러 처리는 아래의 문단을 확인하시기 바랍니다.

==== 분류 블러 ====
{| class="wikitable" style="text-align: center;"
| <nowiki>[[분류:블러 처리 된 분류@@blur]]</nowiki>
| [[분류:블러 처리 된 분류@@blur]] 상단 분류값 확인
|-
! 입력값
! 출력값
|}

분류 중에 블러 처리를 하기 원하는 경우, 분류명 맨 뒤에 <code><nowiki>@@blur</nowiki></code>를 붙이면, 블러 처리가 됩니다. 단, 자바스크립트를 허용(기본적으로는 허용되어 있음)해야만 작동하며, 자바스크립트에서 처리하기 때문에 약간의 시간이 걸릴 수 있습니다.

=== 해시갑 계산 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><hash type="sha256">안녕하세요</hash></nowiki>
| <hash type="sha256">안녕하세요</hash>
|-
! 입력값
! 출력값
|}

태그 안의 값을 <code>type</code> 속성으로 지정한 해시 방식으로 해시화 한 뒤 결과값을 출력합니다. PHP 버전 및 모듈에 따라 다르지만, 사용 가능한 방식은 <code>md2 / md4 / md5 / sha1 / sha224 / sha256 / sha384 / sha512/224 / sha512/256 / sha512 / sha3-224 / sha3-256 / sha3-384 / sha3-512 / ripemd128 / ripemd160 / ripemd256 / ripemd320 / whirlpool / tiger128,3 / tiger160,3 / tiger192,3 / tiger128,4 / tiger160,4 / tiger192,4 / snefru / snefru256 / gost / gost-crypto / adler32 / crc32 / crc32b / crc32c / fnv132 / fnv1a32 / fnv164 / fnv1a64 / joaat / haval128,3 / haval160,3 / haval192,3 / haval224,3 / haval256,3 / haval128,4 / haval160,4 / haval192,4 / haval224,4 / haval256,4 / haval128,5 / haval160,5 / haval192,5 / haval224,5 / haval256,5</code>가 있습니다.

=== 접기 펼치기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><folding>안녕하세요</folding></nowiki><br><nowiki><folding>제목||내용입니다</folding></nowiki>
| <folding>안녕하세요</folding><br><folding>제목||내용입니다</folding>
|-
! 입력값
! 출력값
|}

내용이 길어 접었다가 상세한 내용을 보기를 원하는 사용자가 클릭하면 숨겨진 내용이 나오도록 할 수 있습니다. 제목과 내용 부분은 <code>||</code>로 구분하며, 만약 구분하지 않고 내용만 입력하면 '''[접기 · 펼치기]''' 가 제목으로 나오게 됩니다.

=== 아스키 유니코드 변환 ===
==== 아스키 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><ascii type="str" to="10">h</ascii></nowiki>
| <ascii type="str" to="10">h</ascii>
|-
! 입력값
! 출력값
|}

아스키 코드를 변환합니다. <code><ascii type="{문자(str)/10진수(10)/16진수(16)}" to="{문자(str)/10진수(10)/16진수(16)}">값</ascii></code> 형태로 입력하며, 여러 값이 있더라도 맨 첫번째 값<ref>hello라고 입력하면 h</ref>만 계산됩니다.

==== 유니코드 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode></nowiki>
| <unicode type="16" to="str">U+1100, U+1161, U+11BC, U+1102, U+1161, U+11B7</unicode>
|-
! 입력값
! 출력값
|}

유니코드를 변환합니다. 유니코드 값을 <code>U+XXXX</code> 형태로 입력하면 그 값을 반환합니다.

=== 문자열 길이 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><len>Pneumonoultramicroscopicsilicovolcanoconiosis</len></nowiki>
| <len>Pneumonoultramicroscopicsilicovolcanoconiosis</len>
|-
! 입력값
! 출력값
|}

문자열의 길이를 반환합니다. 띄어쓰기와 특수문자를 모두 반영합니다.

=== 문자열 갯수 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count></nowiki>
| <count value="shell">She sells seashells on the seashore, and the shells she sells are surely seashells.</count>
|-
! 입력값
! 출력값
|}

원하는 문자열이 몇개 들어있는지를 반환합니다. 대소문자를 구분합니다.

=== 전부 대(소)문자로 변환 ===
==== 전부 대문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><upper>hello i am a boy!</upper></nowiki>
| <upper>hello i am a boy!</upper>
|-
! 입력값
! 출력값
|}

모든 글자를 대문자로 변환합니다.

==== 전부 소문자로 변환 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><lower>HELLO MR MY YESTERDAY</lower></nowiki>
| <lower>HELLO MR MY YESTERDAY</lower>
|-
! 입력값
! 출력값
|}

모든 글자를 소문자로 변환합니다.

=== 대(소)문자 여부 ===
==== 대문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><isupper>HELLO I AM A BOY!</isupper></nowiki>
| <isupper>HELLO I AM A BOY!</isupper>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 대문자인 경우 <code>True</code>를, 소문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

==== 소문자 여부 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><islower>hello Mr my yesterday</islower></nowiki>
| <islower>hello Mr my yesterday</islower>
|-
! 입력값
! 출력값
|}

입력한 값이 모두 소문자인 경우 <code>True</code>를, 대문자가 섞여 있으면 <code>False</code>를 반환합니다. 특수문자, 띄어쓰기 등 알파벳이 아닌 문자는 무시됩니다.

=== 문자열 뒤집기 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><reverse>Hello</reverse></nowiki>
| <reverse>Hello</reverse>
|-
! 입력값
! 출력값
|}

입력한 문자열을 뒤집어 출력합니다.

=== 공백 제거 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces></nowiki>
| <rmspaces>The sun slowly set behind the mountains, casting a beautiful orange glow across the sky.</rmspaces>
|-
! 입력값
! 출력값
|}

공백을 제거합니다.

=== 정렬 ===
==== 오름차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-asc>Friendship</sort-asc></nowiki>
| <sort-asc>Friendship</sort-asc>
|-
! 입력값
! 출력값
|}

오름차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 대문자가 우선합니다.

==== 내림차순 정렬 ====
{| class="wikitable" style="text-align: center;"
| <nowiki><sort-desc>Friendship</sort-desc></nowiki>
| <sort-desc>Friendship</sort-desc>
|-
! 입력값
! 출력값
|}

내림차순으로 정렬합니다. 아스키 코드를 기준으로 하기 때문에 소문자가 우선합니다.

=== 글자 및 배경색 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><wordclr color="red" bg="yellow">Hello, world!</wordclr></nowiki>
| <wordclr color="red" bg="yellow">Hello, world!</wordclr>
|-
! 입력값
! 출력값
|}

글자 색과 배경색을 지정할 수 있습니다. <code>color</code>값을 지정하지 않으면 <code>black</code>으로, <code>bg</code>를 지정하지 않으면 투명(없음)으로 설정됩니다.

=== 수평줄 ===
'''입력값: '''<code><nowiki>-----</nowiki></code><br>
'''출력값: '''
-----

<code>-</code>을 4개 이상 입력하면 수평줄이 생깁니다. 단, 단독으로 사용해야 하며 앞에 공백 등이 있으면 작동하지 않습니다.

=== URL 인코딩 디코딩 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><urlencode>안녕하세요!</urlencode></nowiki><br><nowiki><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode></nowiki>
| <urlencode>안녕하세요!</urlencode><br><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode>
|-
! 입력값
! 출력값
|}

url 값을 인코딩 시키거나 디코딩 시켜서 반환합니다.

=== 마크다운 뱃지 ===
{| class="wikitable" style="text-align: center;"
| <nowiki><mdbadge type='language' value='php'></mdbadge></nowiki>
| <urlencode>안녕하세요!</urlencode><br><urldecode>%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94%21</urldecode>
|-
! 입력값
! 출력값
|}
<code></code><code></code><code></code><code></code><code></code><code></code><code></code><code></code><code></code>

가온 위키:대문

2023-05-31T00:24:59Z

Admin: 공지 업데이트

<div style="border-top: 10px solid #00BCD4; padding: 3px; box-shadow: 3px 3px 13px #B3B3B3; text-align: center; border-radius:10px;>
<div>
<big>모두의 <s>마블</s>, 가온 위키!<br><br></big>

<p style="margin-top: -20px; font-size: 25px;>[[가온 위키]]에 오신 것을<br>환영합니다!</p>
</div>
<big>[[가온 위키]]는 누구든 참여 할 수 있는 위키 입니다!</big>
</div>

<br>

<hr />

<div id="notice" style="border: solid #e1e8ed; padding: 25px;">
{| class="mw-collapsible" style="margin: auto;"
| align="center" | <big><big><big><big>공지사항<br><br></big></big></big></big>
|-
| <br>1. 단축 URL 생성, 코드 공유 서비스 임베드를 할 수 있어요. [https://bbs.gaonwiki.com/notice/4702 공지 게시글]에서 더욱 자세히 알아보세요!
|-
| <br>2. 위키의 부족한 문법을 개선하고 있습니다. 기다려 주세요!
|-
| <br>3. 스크롤 프로그래스 바를 스킨에서 분리해 확장기능으로 동작하도록 했습니다.
|-
| <br>민방위, 지진 대피소 위치 정보를 추가해 봅시다! 공공데이터포털에서 대피소 정보에서 ''''이용허락범위 제한 없음''''으로 된 정보와, 각 지자체 사이트의 정보를 활용합시다. '''국민재난안전포털은 공공누리 4유형이므로 피하고, 공공누리 저작물 사용 시, 1유형만 사용'''하도록 해주시기 바랍니다.
|-
| align="center" | <hr /> 자세한 내용은<br> [https://bbs.gaonwiki.com/notice 공지사항 게시판]을 확인해 주세요!
|}
</div>

가온 위키:기능 구현 불가-누가 해결책을 알려주세요!

2023-05-23T13:28:08Z

Admin: /* 구현한 기능 */ 단축 URL 추가

==이 문서는...==
답답한 우리의 [[사용자:Admin|가온 위키 관리자]]가 구현하지 못해, 착한 유저가 해결책을 제시한 경우, 감사의 표시로 이곳과 [[가온 위키 커뮤니티]]에 표시하는 곳입니다.<br/>

==구현 못한 부분==
* 아직까지 없습니다.

==해결됨==

===리버티 스킨 관련 문제===
리버티 스킨과 관련된 문제는 [[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!/리버티 스킨]] 문서를 참고하자.

===영상 가져오기(Embed) 관련 문제===
외부 서비스들 중에서 가져오지 못하는 것들은 [[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!/영상 가져오기]] 문서를 참고하자!

===이미지 관련 문제===
====이미지 크기 설정시 파일 링크만 뜨는 현상====
<nowiki>[[파일:updates.png|100px]]</nowiki> 이렇게 하면 일반 문서처럼 링크로 뜬다. 서버 이전 전에는 이러지 않았는데...

[https://m.mediawiki.org/w/index.php?title=Topic:Rnjccxoqss9wfedy&topic_showPostId=rnq05rzcc6o7z4hc#flow-post-rnq05rzcc6o7z4hc 미디어위키 헬프 데스크]에서 찾았다.

=====수정 전=====
[[미디어위키]]의 루트 폴더에 있는 [[미디어위키/LocalSettings.php|LocalSettings.php]]를 수정한다.

=====수정 후=====
[[LocalSettings.php]]의 하단 부분에 추가하자.
<syntaxhighlight lang='php'>
$wgGenerateThumbnailOnParse = true;
</syntaxhighlight>

그리고 [[미디어위키]] 버전이 1.30 이상인 경우, 썸네일을 재생성하자. [[미디어위키]]의 루트 폴더에서 '''maintenance''' 폴더로 이동한 뒤, 아래의 명령어를 입력하자.

<syntaxhighlight lang='console'>
root@gaon:/var/www/html/w/maintenance# php rebuildImages.php
</syntaxhighlight>

=====하고 싶은말=====
이 오류는 [[미디어위키]] 1.27 버전에서는 없던 오류이므로 1.30 이상 버전의 오류같다. 물론 썸네일은 [[Imagemagick]]가 미리 설치 및 [[미디어위키]]에서 미리 설정 되어 있어야 한다.

====SVG 파일 업로드시 썸네일의 흑백화====
SVG 파일을 업로드하면 원래 가지고 있던 색상값은 표시되지 않고 흑백으로만 표시가 된다. 이는 SVG를 png로 변환하는 프로그램인 ImageMagick의 특정 버전에서 나타난 오류이다. [https://bbs.gaonwiki.com/free/3877 zlzleking님]이 보고해 주셨다.

=====수정 전=====
먼저 Inkscape를 설치한다. 우분투 기준으로 아래의 명령어를 입력하면 된다.
<syntaxhighlight lang='console'>
root@gaon:/# apt update
root@gaon:/# apt install inkscape
</syntaxhighlight>

이후 [[미디어위키]]의 루트 폴더에 있는 [[미디어위키/LocalSettings.php|LocalSettings.php]]를 수정한다.

<syntaxhighlight lang='php'>
$wgSVGConverter = 'ImageMagick';
</syntaxhighlight>

=====수정 후=====
[[LocalSettings.php]]의 하단 부분에 추가하자. Inkscape의 경로는 자신의 환경에 맞춰 수정하자.
<syntaxhighlight lang='php'>
$wgSVGConverterPath = '/usr/bin/inkscape';
$wgSVGConverters = [
'Inkscape' => '/usr/bin/inkscape -w $width -z -w $width -f $input -e $output',
];
$wgSVGConverter = 'Inkscape';

#$wgSVGConverter = 'ImageMagick';
</syntaxhighlight>

여기서
<syntaxhighlight lang='php'>
$wgSVGConverter = 'ImageMagick';
</syntaxhighlight>
부분은 반드시 주석처리 한다.

그리고 [[미디어위키]] 버전이 1.30 이상인 경우, 썸네일을 재생성하자. [[미디어위키]]의 루트 폴더에서 '''maintenance''' 폴더로 이동한 뒤, 아래의 명령어를 입력하자.

<syntaxhighlight lang='console'>
root@gaon:/var/www/html/w/maintenance# php rebuildImages.php
</syntaxhighlight>

===신택스 강조(Syntax Highlight) 사용시 사용된 문서가 '''구문 강조에 오류가 있는 문서'''로 분류되는 현상===
미디어위키 1.33.1 버전에 있는 [[미디어위키/확장기능/SyntaxHighlight|SyntaxHighlight 확장기능]]을 사용하는 경우, "구문 강조에 오류가 있는 문서"로 자동 분류된다.

미디어위키 코어에 포함되어 있는 버전만 파이썬 전역 환경변수 처리를 요구한다.

====구버전 사용====
1.32.x 버전의 구버전을 사용하는 방법이다.
웹호스팅과 같이 서버를 직접 조작하지 못하는 경우에 사용하면 된다.

[https://www.mediawiki.org/wiki/Special:ExtensionDistributor/SyntaxHighlight_GeSHi SyntaxHighlight 다운로드 페이지]로 이동 후, 미디어위키 버전을 1.32 버전으로 설정 후, 기존에 있던 확장기능 삭제 후 새로 받은 버전으로 업로드 한다.

====확장기능 페이지서 1.33버전으로 다운로드====
이상하게 1.33 버전으로 다운로드 받아도 작동한다. 아마도 코어 파일에 포함되어 있는 버전만 파이썬 전역 환경변수 처리해야 하는 것 같다.

이후 미디어위키 1.34 코어에 포함된 버전은 해당 문제가 발생하지 않는다. 1.33.1에 포함된 버전만 문제인 것 같다.

====파이썬3 설치====
1.35.1 기준, 서버에 파이썬3를 설치하면 해당 문제는 발생하지 않는다.

설치방법은 쉘에

<syntaxhighlight lang='console'>
root@gaon:/# apt update && apt -y install python3
</syntaxhighlight>

이라고 입력한다. 설치가 되었는지 확인하려면,
<syntaxhighlight lang='console'>
root@gaon:/# python3 --version
Python 3.8.5
</syntaxhighlight>
이라고 입력한다. 이때 버전은 위의 버전과 다를 수 있다.

===TitleKey 확장기능 설치===
대소문자 구분 없이 문서를 검색 할 수 있는 [[미디어위키/확장기능/TitleKey|TitleKey]] 설정 중, <code>php extensions/TitleKey/maintenance/rebuildTitleKeys.php</code> 명령어를 입력할 때, 경로를 찾지 못하는 문제가 있다.

이 문제는 환경변수 <code><nowiki>$IP</nowiki></code>가 경로를 제대로 반환하지 않아 생기는 문제이다.

여기서는 환경변수 <code><nowiki>$IP</nowiki></code>를 수정하지 않고, 9번째 줄을 절대경로로 바꾸어 사용했다. 사용 환경에 맞추어 수정하길 바란다.

====수정 전====
<syntaxhighlight lang='php' start='5' highlight='5'>
$IP = getenv( 'MW_INSTALL_PATH' );
if ( $IP === false ) {
$IP = __DIR__ . '/../..';
}
require_once "$IP/maintenance/Maintenance.php";

// In case we want to do offline initialization...
if ( !class_exists( 'TitleKey' ) ) {
require __DIR__ . '/../includes/TitleKey.php';
}
</syntaxhighlight>

====수정 후====
<syntaxhighlight lang='php' start='5' highlight='5'>
$IP = getenv( 'MW_INSTALL_PATH' );
if ( $IP === false ) {
$IP = __DIR__ . '/../..';
}
require_once "/var/www/html/w/maintenance/Maintenance.php";

// In case we want to do offline initialization...
if ( !class_exists( 'TitleKey' ) ) {
require __DIR__ . '/../includes/TitleKey.php';
}
</syntaxhighlight>

또는 상대경로로 지정해도 된다. 이 경우에는 미디어위키 설치 경로에 구애받지 않는다는 장점이 있다.

<syntaxhighlight lang='php' start='5' highlight='5'>
$IP = getenv( 'MW_INSTALL_PATH' );
if ( $IP === false ) {
$IP = __DIR__ . '/../..';
}
require_once "../../../maintenance/Maintenance.php";

// In case we want to do offline initialization...
if ( !class_exists( 'TitleKey' ) ) {
require __DIR__ . '/../includes/TitleKey.php';
}
</syntaxhighlight>

==비주얼 에디터 설치==
비주얼 에디터를 설치하고, 사용할 수 있다. 다만 짧은 주소 설정시 오류가 발생할 수 있으므로 본 코드를 사용하자.

===짧은 주소 설정(선택, 권장)===
짧은 주소를 설정하자. .htaccess를 사용하므로 아파치 이용자만 할 수 있다.(짧은 주소 자체는 nginx도 할 수 있지만, 서술하지 않음).

먼저 [[미디어위키/LocalSettings.php|LocalSettings.php]]가 있는 루트 폴더로 이동하여 .htaccess를 열자. 없으면 생성하자.

이후 아래와 같이 입력한다.

<syntaxhighlight>
RewriteEngine On
RewriteBase /w/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /w/index.php [L]

RewriteCond %{HTTP_USER_AGENT} !^(VisualEditor)
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
RewriteRule ^(.*)$ %{DOCUMENT_ROOT}/index.php [L]

RewriteCond %{HTTP_USER_AGENT} !^(VisualEditor)
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
RewriteRule ^/?images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/thumb.php?f=$1&width=$2 [L,QSA,B]

RewriteCond %{HTTP_USER_AGENT} !^(VisualEditor)
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
RewriteRule ^/?images/thumb/archive/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/thumb.php?f=$1&width=$2&archived=1 [L,QSA,B]
</syntaxhighlight>

여기서 2번째 줄과 6번째 줄에 있는 <code>/w/</code> 부분에 원하는 줄임(<nowiki>https://example.com/w/문서명</nowiki>) 단어를 입력한다.

[https://wnw1005.tistory.com/168 출처 : 씨실과 날실님 티스토리 블로그], [https://www.mediawiki.org/wiki/Topic:W2ahzg3yi27mvp9y 미디어위키 토론 중 Rogerhc님의 답변]

이후 LocalSettings.php 하단에 다음과 같이 입력한다.
<syntaxhighlight lang='php'>
$wgScriptExtension = ".php";
$wgArticlePath = "{$wgScriptPath}/$1";
$wgUsePathInfo = true;
</syntaxhighlight>

===비주얼 에디터 설치===
1.37버전은 이미 extensions 폴더에 있다. 코어에 포함되어 있으나, 삭제한 사람은 [https://www.mediawiki.org/wiki/Extension:VisualEditor 미디어위키 비주얼 에디터 페이지]에서 자신의 버전에 맞게 다운로드 받은 뒤 extensions 폴더 안에 넣는다.

이후 LocalSettings.php 하단에 다음과 같이 입력한다.
<syntaxhighlight lang='php'>
wfLoadExtension( 'VisualEditor' );
</syntaxhighlight>

이러면 끝이다.

== 미디어위키 1.39 버전 업그레이드 이후 분류값 앞에 점이 표시되고 세로로 정렬되는 문제 ==
미디어위키 1.39 rc버전에서는 이런 문제가 없었지만, 1.39 정식버전에서는 분류값 앞에 점이 표시되고, 세로로 정렬되는 문제가 있다. 또한 분류값이 '''분류:'''밑에 줄에 표시되는 문제가 있다.
[[파일:미디어위키1_39_분류_문제.png]]

이는 [[미디어위키:Common.css]] 문서를 수정하면 된다.

=== 수정 전 ===
<syntaxhighlight lang='css'>
/* 이 CSS 설정은 모든 스킨에 적용됩니다 */
.mw-highlight pre {
font-size: 90%;
}
</syntaxhighlight>

=== 수정 후 ===
<syntaxhighlight lang='css'>
/* 이 CSS 설정은 모든 스킨에 적용됩니다 */
.mw-highlight pre {
font-size: 90%;
}

/* 1.39 버전에서 분류 표시가 li로 표시돠는 문제 해결 */
#mw-normal-catlinks > ul {
list-style: none;
}

#mw-normal-catlinks > ul > li {
float: left;
margin-right: 15px;
}

/* 분류: 밑부분에 분류값이 표시되는 문제 해결 */
#mw-normal-catlinks {
display: flex;
align-items: center;
}
</syntaxhighlight>

==구현한 기능==
=== 인디케이터 표시 ===
[https://github.com/merlinwarage/simple-scroll-progress simple-scroll-progress]를 이용하여 스크롤한 범위를 표시하는 기능입니다.

[[파일:리버티 스킨-스크롤 범위.gif]]<ref>초기의 타 라이브러리를 사용한 모습. 현재 버전은 본 위키에 적용되어 있다.</ref>

혹시 사용하고 싶다면, [https://github.com/gaon12/Liberty Liberty 깃허브 저장소]를 다운로드 받아 사용하면 된다. 라이브러리는 외부에서 불러오니 참고하자.

=== 클라우드플레어 원본 IP 주소 표시 ===
클라우드플레어 사용 시, 비로그인 유저가 문서를 편집하는 경우, ip주소가 클라우드플레어의 ip로 기록됩니다. 이를 수정해주는 확장기능을 개발하여 배포합니다.

{{깃허브/저장소|gaon12|mw_CloudflareRealIP}} 확장기능을 설치하면, 원본 IP 주소가 표시됩니다.

==== 설치 ====
# 먼저 GitHub 저장소에서 확장기능을 다운로드하세요.
# 다운로드 받은 확장기능을 미디어위키의 "extensions" 폴더에 업로드합니다.
# 미디어위키의 "LocalSettings.php" 파일을 찾아 아래 코드를 추가하세요

<br>
<syntaxhighlight lang='php'>
wfLoadExtension( 'CloudflareRealIP' );
</syntaxhighlight>

==== 사용법 ====
이 확장기능을 설치하고 나면 아무런 추가 설정 없이 자동으로 작동합니다. CloudflareRealIP 확장기능은 미디어위키에서 로그인하지 않고 편집할 때 Cloudflare의 IP 주소 대신 원래 사용자의 IP 주소를 저장합니다.

==== 참고 사항 ====
이 확장기능은 미디어위키 1.25 이상과 호환됩니다. 또한 Cloudflare 서비스를 사용하는 경우에만 필요하며, Cloudflare를 사용하지 않거나 단순히 DNS만 사용하는 경우 설치할 필요가 없습니다.

==== 원리 ====
Cloudflare Real IP 확장 기능의 작동 원리는 다음과 같습니다:

# 사용자가 미디어위키에서 로그인하지 않고 편집을 진행합니다.
# Cloudflare는 사용자의 원래 IP 주소를 "CF-Connecting-IP"라는 HTTP 헤더를 통해 전달합니다.
# 미디어위키에서는 로그인하지 않은 사용자의 IP 주소를 기록하려 할 때 UserGetIP 이벤트가 발생합니다.
# Cloudflare Real IP 확장 기능은 이 이벤트를 통해 사용자의 IP 주소를 가져옵니다.
# 확장 기능은 $_SERVER['HTTP_CF_CONNECTING_IP'] 변수를 확인하여 Cloudflare가 전달한 원래 사용자의 IP 주소가 있는지 확인합니다.
# 원래 사용자의 IP 주소가 있다면, 확장 기능은 이 IP 주소로 미디어위키에 저장되는 IP 주소를 변경합니다.
# 결과적으로, 미디어위키에서 로그인하지 않은 사용자의 편집 기록에 원래 사용자의 IP 주소가 저장됩니다.

이 확장 기능을 사용하면 Cloudflare를 사용하는 경우에도 미디어위키에서 로그인하지 않은 사용자의 원래 IP 주소를 정확하게 기록할 수 있습니다. 이로 인해 IP 주소를 기반으로 한 사용자 관리 및 안전 조치가 훨씬 간편해집니다.

==== 라이선스 ====
[[MIT 라이선스]]로 배포됩니다.

=== 단축 URL 생성 ===
긴 문서의 URL, 특히 문서명이 한글로 이루어져 있는 경우, URL이 길어져 공유할 때 불편합니다. 그래서 단축 URL을 생성하고, 복사할 수 있는 기능을 추가했습니다.

==== 사용 방법 ====
문서 최하단에 CCL 표기 부분과 '''개인정보처리방침 가온 위키 소개 면책 조항''' 링크 부분 사이에 '''• 현재 페이지 URL 줄이기''' 메뉴를 누르면, 팝업창이 뜨면서 현재 문서의 단축된 URL이 생성이 됩니다.

==== 원리 ====
[[미디어위키]]에는 문서를 편집할 때마다, 문서의 역사에 고유한 번호를 부여합니다. 이 번호는 <code>oldid</code>로, 1부터 편집할 때마다 1씩 증가합니다. 자세한 내용은 [[미디어위키/oldid]] 문서를 참고하세요!

<code>oldid</code> 값을 62진법<ref>숫자(0-9) + 알파벳 대문자(A-Z) + 알파벳 소문자(a-z)</ref>으로 변환하여 단축된 URL을 제공합니다. 일반 문서와 혼동이 생기지 않도록, <code>/a/</code> 경로로 제공됩니다.

==== 주의사항 ====
* <code>oldid</code> 값은 문서가 편집되면 새롭게 바뀌므로, 예전에 생성된 URL 값과 현재의 URL 값에는 차이가 있을 수 있습니다. 하지만 둘 다 원래의 문서로 자동으로 이동하므로 걱정하지 않아도 됩니다.
* 특수 문서, 편집 페이지 등 <code>oldid</code> 값이 존재하지 않는 페이지에는 본 메뉴가 생성되지 않습니다.

==각주==

미디어위키/oldid

2023-05-23T13:27:56Z

Admin: 데이터베이스에서 확인하는 방법 추가

== 개요 ==
<code>oldid</code>는 미디어위키에서 각 문서 수정 시점의 리비전을 구분하기 위한 고유 식별자(ID)입니다. 이를 통해 특정 리비전에 직접 참조하거나 문서가 시간에 따라 어떻게 변화했는지를 추적하는 데 유용합니다.

== oldid의 생성 ==
미디어위키에서 새로운 문서를 작성하거나 기존 문서를 편집할 때마다 새로운 리비전이 생성되며, 이에 따라 고유한 oldid가 생성됩니다. 특수 문서를 제외한 모든 문서에는 최소 한개 이상<ref>문서 생성시에도 <code>oldid</code>가 생성되기 때문</ref>의 <code>oldid</code>가 존재하게 됩니다.

== oldid 찾는 방법 ==
=== 일반 유저가 찾는 방법 ===
원하는 위키 문서로 이동합니다.
상단 메뉴에서 "역사 보기"를 클릭합니다.
해당 페이지의 역사 목록에서 원하는 리비전을 찾습니다.
원하는 리비전의 날짜/시간 링크를 클릭하면, 해당 리비전으로 이동하게 됩니다. 이때의 URL에는 <code>oldid</code> 값이 포함되어 있습니다.

예를 들어 대문 페이지인 [[가온 위키:대문]]의 <code>oldid</code>값은 문서의 우측 상단의 [https://www.gaonwiki.com/w/index.php?title=가온_위키:대문&action=history 문서 역사]에서 편집 유저명 옆에 있는 날짜-시간 부분의 URL을 보면...

<nowiki>https://www.gaonwiki.com/w/index.php?title=가온_위키:대문&oldid=106857</nowiki>

여기에서 맨 뒷부분에 있는 <code>oldid=106857</code> 부분이 바로 <code>oldid</code> 값이 됩니다.

=== PHP로 찾는 방법 ===
미디어위키 API를 사용하여 oldid를 얻을 수 있습니다. 다음은 PHP로 oldid를 찾는 예제 코드입니다:

<syntaxhighlight lang='php'>
<?php
$apiUrl = 'https://yourwikiurl.org/w/api.php';

$params = [
'action' => 'query',
'prop' => 'revisions',
'titles' => 'Hello',
'rvlimit' => 1,
'format' => 'json'
];

$url = $apiUrl . '?' . http_build_query($params);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$output = curl_exec($ch);
curl_close($ch);

$response = json_decode($output, true);

$pages = $response['query']['pages'];
foreach ($pages as $page) {
if (isset($page['revisions'][0]['revid'])) {
$oldid = $page['revisions'][0]['revid'];
echo "The oldid is: $oldid\n";
}
}
?>
</syntaxhighlight>

이 코드는 'Hello'이라는 제목의 문서의 가장 최신 리비전의 <code>oldid</code> 값을 찾습니다.

=== 데이터베이스에서 찾는 방법 ===
미디어위키가 설치되어 있는 데이터베이스에서 <code>mw_text</code> 테이블에 존재합니다. 테이블 구조는 다음과 같습니다.

{| class="wikitable" style="text-align: center;"
! 컬럼 || 타입
|-
| old_id || int unsigned(자동 증가)
|-
| old_text || mediumblob
|-
| old_flags || tinyblob
|}

여기서 <code>old_id</code> 컬럼에 <code>oldid</code>값을 확인할 수 있습니다.

== oldid 활용 방법 ==
<code>oldid</code>를 활용하면 문서의 특정 리비전에 대한 참조를 보존하거나, 문서가 어떻게 시간에 따라 변화했는지 추적할 수 있습니다.

=== oldid로 특정 리비전 링크 생성하기 ===
특정 <code>oldid</code>를 가진 리비전에 대한 링크를 생성하려면, 다음과 같이 URL에 oldid를 포함시킬 수 있습니다:

<nowiki>https://example.com/w/index.php?title=Page_title&oldid=123456789</nowiki>

=== 리비전 비교하기 ===
미디어위키의 '비교 보기' 기능을 사용하여 두 개의 리비전 사이의 차이점을 비교하거나 <code>oldid</code>를 이용하여 문서의 특정 시점의 상태를 확인할 수 있습니다. 이는 문서 편집에 대한 회고, 편집 충돌 해결, 문서 변화의 추적 등에 유용합니다.

== oldid와 편집 충돌 ==
편집 충돌이 발생하면 <code>oldid</code>를 통해 충돌 발생 시점의 리비전을 확인하고, 충돌을 해결할 수 있습니다.

== oldid와 문서 복원 ==
특정 리비전이 실수로 삭제되거나 무분별한 편집<ref>예: 반달</ref>으로 인해 문서의 품질이 저하된 경우, <code>oldid</code>를 이용하여 원하는 시점의 리비전을 복원할 수 있습니다.

== oldid의 한계 ==
oldid는 특정 리비전에 대한 링크를 제공하지만, 문서의 모든 역사를 제공하는 것은 아닙니다. 예를 들어, 특정 리비전이 삭제되면 해당 <code>oldid</code>에 접근할 수 없게 됩니다. 또한, 드물지만 일부 위키에서는 <code>oldid</code>에 대한 접근을 제한할 수 있습니다.

== 각주 ==


[[분류:미디어위키]] [[분류:미디어위키/리비전]]

미디어위키/oldid

2023-05-23T13:14:32Z

Admin: 시작

== 개요 ==
<code>oldid</code>는 미디어위키에서 각 문서 수정 시점의 리비전을 구분하기 위한 고유 식별자(ID)입니다. 이를 통해 특정 리비전에 직접 참조하거나 문서가 시간에 따라 어떻게 변화했는지를 추적하는 데 유용합니다.

== oldid의 생성 ==
미디어위키에서 새로운 문서를 작성하거나 기존 문서를 편집할 때마다 새로운 리비전이 생성되며, 이에 따라 고유한 oldid가 생성됩니다. 특수 문서를 제외한 모든 문서에는 최소 한개 이상<ref>문서 생성시에도 <code>oldid</code>가 생성되기 때문</ref>의 <code>oldid</code>가 존재하게 됩니다.

== oldid 찾는 방법 ==
=== 일반 유저가 찾는 방법 ===
원하는 위키 문서로 이동합니다.
상단 메뉴에서 "역사 보기"를 클릭합니다.
해당 페이지의 역사 목록에서 원하는 리비전을 찾습니다.
원하는 리비전의 날짜/시간 링크를 클릭하면, 해당 리비전으로 이동하게 됩니다. 이때의 URL에는 <code>oldid</code> 값이 포함되어 있습니다.

예를 들어 대문 페이지인 [[가온 위키:대문]]의 <code>oldid</code>값은 문서의 우측 상단의 [https://www.gaonwiki.com/w/index.php?title=가온_위키:대문&action=history 문서 역사]에서 편집 유저명 옆에 있는 날짜-시간 부분의 URL을 보면...

<nowiki>https://www.gaonwiki.com/w/index.php?title=가온_위키:대문&oldid=106857</nowiki>

여기에서 맨 뒷부분에 있는 <code>oldid=106857</code> 부분이 바로 <code>oldid</code> 값이 됩니다.

=== PHP로 찾는 방법 ===
미디어위키 API를 사용하여 oldid를 얻을 수 있습니다. 다음은 PHP로 oldid를 찾는 예제 코드입니다:

<syntaxhighlight lang='php'>
<?php
$apiUrl = 'https://yourwikiurl.org/w/api.php';

$params = [
'action' => 'query',
'prop' => 'revisions',
'titles' => 'Hello',
'rvlimit' => 1,
'format' => 'json'
];

$url = $apiUrl . '?' . http_build_query($params);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$output = curl_exec($ch);
curl_close($ch);

$response = json_decode($output, true);

$pages = $response['query']['pages'];
foreach ($pages as $page) {
if (isset($page['revisions'][0]['revid'])) {
$oldid = $page['revisions'][0]['revid'];
echo "The oldid is: $oldid\n";
}
}
?>
</syntaxhighlight>

이 코드는 'Hello'이라는 제목의 문서의 가장 최신 리비전의 <code>oldid</code> 값을 찾습니다.

== oldid 활용 방법 ==
<code>oldid</code>를 활용하면 문서의 특정 리비전에 대한 참조를 보존하거나, 문서가 어떻게 시간에 따라 변화했는지 추적할 수 있습니다.

=== oldid로 특정 리비전 링크 생성하기 ===
특정 <code>oldid</code>를 가진 리비전에 대한 링크를 생성하려면, 다음과 같이 URL에 oldid를 포함시킬 수 있습니다:

<nowiki>https://example.com/w/index.php?title=Page_title&oldid=123456789</nowiki>

=== 리비전 비교하기 ===
미디어위키의 '비교 보기' 기능을 사용하여 두 개의 리비전 사이의 차이점을 비교하거나 <code>oldid</code>를 이용하여 문서의 특정 시점의 상태를 확인할 수 있습니다. 이는 문서 편집에 대한 회고, 편집 충돌 해결, 문서 변화의 추적 등에 유용합니다.

== oldid와 편집 충돌 ==
편집 충돌이 발생하면 <code>oldid</code>를 통해 충돌 발생 시점의 리비전을 확인하고, 충돌을 해결할 수 있습니다.

== oldid와 문서 복원 ==
특정 리비전이 실수로 삭제되거나 무분별한 편집<ref>예: 반달</ref>으로 인해 문서의 품질이 저하된 경우, <code>oldid</code>를 이용하여 원하는 시점의 리비전을 복원할 수 있습니다.

== oldid의 한계 ==
oldid는 특정 리비전에 대한 링크를 제공하지만, 문서의 모든 역사를 제공하는 것은 아닙니다. 예를 들어, 특정 리비전이 삭제되면 해당 <code>oldid</code>에 접근할 수 없게 됩니다. 또한, 드물지만 일부 위키에서는 <code>oldid</code>에 대한 접근을 제한할 수 있습니다.

== 각주 ==


[[분류:미디어위키]] [[분류:미디어위키/리비전]]

코드 임베딩

2023-05-23T04:38:41Z

Admin: 시작

== 개요 ==
2023년 05월 패치 중, 다양한 코드 공유 사이트들을 임베딩 할 수 있는 확장기능을 추가했습니다. 본 문서는 각 서비스 별 사용 방법에 대해 기술합니다.

== 한계 ==
* StackBlitz를 임베딩 할 때, ID만 입력하는 방식으로 사용할 때 주의하시기 바랍니다. Replit과 동시에 사용하는 경우, Preview가 계속 로딩이 되면서 'Connecting to dev server...'라고 뜨는 문제가 생기는 문제가 있습니다.
* 주피터 노트북은 직접 실행할 수 없고, 결과 화면을 HTML로 변환하여 임베딩 합니다. 또한 외부 서비스에서 읽어와 보여주는 방식이므로, URL 주소가 외부에서 접근할 수 있어야 합니다.

== Codepen ==
=== Full URL ===
입력값: <nowiki><codepen>https://codepen.io/ztephanuz7/pen/XWeKgaZ</codepen></nowiki>
<codepen>https://codepen.io/ztephanuz7/pen/XWeKgaZ</codepen>

=== Username/pen/ID ===
입력값: <nowiki><codepen>chrisgannon/pen/dypvKvR</codepen></nowiki>
<codepen>chrisgannon/pen/dypvKvR</codepen>

== codesandbox ==
=== Full URL ===
입력값: <nowiki><codesandbox>https://codesandbox.io/s/three-js-initial-forked-t81ck4</codesandbox></nowiki>
<codesandbox>https://codesandbox.io/s/three-js-initial-forked-t81ck4</codesandbox>

=== ID Only ===
입력값: <nowiki><codesandbox>koh-test-forked-e5v71k</codesandbox></nowiki>
<codesandbox>koh-test-forked-e5v71k</codesandbox>

== jsfiddle ==
=== Full URL ===
입력값: <nowiki><jsfiddle>https://jsfiddle.net/theo/VsWb9/</jsfiddle></nowiki>
<jsfiddle>https://jsfiddle.net/theo/VsWb9/</jsfiddle>

=== Username/ID ===
입력값: <nowiki><jsfiddle>retorillo/vw5r78zc</jsfiddle></nowiki>
<jsfiddle>retorillo/vw5r78zc</jsfiddle>

== Replit ==
=== Full URL ===
입력값: <nowiki><replit>https://replit.com/@19hancock5767/The-best-python</replit></nowiki>
<replit>https://replit.com/@19hancock5767/The-best-python</replit>

=== @Username/ID ===
입력값: <nowiki><replit>@mooboo23/python-code</replit></nowiki>
<replit>@mooboo23/python-code</replit>

== StackBlitz ==
=== Full URL ===
입력값: <nowiki><stackblitz>https://stackblitz.com/edit/angular-ivy-1ynhkh?file=src%2Fapp%2Fapp.component.ts</stackblitz></nowiki>
<stackblitz>https://stackblitz.com/edit/angular-ivy-1ynhkh?file=src%2Fapp%2Fapp.component.ts</stackblitz>

=== ID Only ===
입력값: <nowiki><stackblitz>typescript-msfpva</stackblitz></nowiki>
<stackblitz>typescript-msfpva?file=index.ts</stackblitz>

== Glitch ==
=== Full URL ===
입력값: <nowiki><glitch>https://glitch.com/edit/#!/darkened-citrine-kicker?path=server.js%3A1%3A0</glitch></nowiki>
<glitch>https://glitch.com/edit/#!/darkened-citrine-kicker?path=server.js%3A1%3A0</glitch>

=== ID Only ===
입력값: <nowiki><glitch>lumbar-harmless-watch</glitch></nowiki>
<glitch>lumbar-harmless-watch</glitch>

== Jupiter Notebook ==
<jupiter>https://beta.gaonwiki.com/BreamAndSmelt_Version3.ipynb</jupiter>

가온 위키:대문

2023-05-17T07:41:45Z

Admin: 프리뷰 기능을 먼저 사용해 보세요!