매뉴얼

From S2NANO Wiki
Jump to: navigation, search
Wiki manual main image.png

이 문서는 S2NANO Wiki 를 사용하기 위한 매뉴얼입니다. 천천히 읽어보시기를 권장합니다.

S2NANO Wiki 는 오픈소스인 미디어위키(ver 1.26)를 기반으로 제작되어지고 있습니다.

Wiki 접속 및 계정관리

  • 현재 S2NANO Wiki는 로그인 하지 않으면 문서 편집/보기 등을 할 수가 없습니다.
  • 현재 계정생성은 제한되어 있습니다. 관리자(OSCube)에게 문의 바랍니다.
  • S2NANO Wiki는 다양한 언어를 지원하며 기본 언어는 영어를 사용합니다.
  • S2NANO Wiki의 주소는 http://nanowiki.s2nano.org 입니다.

로그인 하여 우측 상단에 [preference] 또는 [환경 설정]을 선택하여 사용자 환경 설정이 가능합니다.

Preferences / 환경 설정

기본언어가 영어로 지정되어 있는것을 변경하고 싶으면 언어 설정에서 한국어[en - English -> ko - 한국어] 로 바꾸시고 하단 [Save] 또는 [저장] 버튼을 누르시면 사용자는 한국어로 위키를 사용할 수 있습니다.

Manual preferences.png

※ 드롭다운 메뉴 클릭 후 키보드로 'ko' 를 입력하면 빨리 찾을 수 있습니다.

문서 생성

Wiki 의 문서 생성하기 전에 생성하고자 하는 문서가 있는지 먼저 확인하는 것이 우선입니다.

문서 검색

S2NANO Wiki Main Page

S2NANO Wiki 의 메인화면과 검색페이지 에서 문서 검색이 가능합니다.

그림의 하단의 [이동] 버튼은 해당 문서로 바로 이동하는 버튼이며

[본문 검색] 은 텍스트박스에 입력된 내용을 문서의 제목과 내용으로 검색한 결과를 보여줍니다.

그림의 상단 빨간네모 박스는 모든 문서에서 보여지는 박스 이며 [이동] 버튼과 같은 기능을 합니다.

검색 결과 (문서 없음)

Manual search result N.png

검색 결과 (문서 있음)

Manual search result Y.png

검색 특이사항

  1. 영문으로 시작하는 문서의 첫글자는 무조건 대문자입니다. 소문자로 검색 및 작성해도 자동으로 대문자로 변환됩니다.
  2. 문서의 첫글자를 제외하고 나머지 글자에 대해서는 대소문자를 구분합니다. (문서명 Test = test / Test ≠ TEst)
  3. 존재하지 않는 문서는 빨간색링크 로 표시되고 존재하는 문서는 파란색링크 로 표시됩니다.
  4. 띄어쓰기는 언더바( _ ) 로 자동인식 됩니다. 하이픈 ( - ) 과는 다르게 인식합니다.
  5. 작성하고자 하는 문서와 유사한 내용이 있을때에는 해당 문서를 편집하시면 됩니다.

처음 생성하기

검색 후 존재하지 않는 문서를 처음 생성하는 것은 간단합니다.

http://nanowiki.s2nano.org/index.php/[생성하고자 하는 문서명]

위와 같이 문서명을 입력([ ] 제외) 후 접속되는 페이지에서 [만들기] 를 누르면 문서의 생성이 가능합니다.

[원본 만들기] 는 원본 편집으로 작성되오니 [만들기] 를 누르시어 VisualEditor를 사용하시기 바랍니다.

문서 편집

Manual edit menu.png

Wiki 문서를 편집하는 방법은 크게 두가지로 나뉩니다.

문서 편집에 필요한 기능을 모아 놓은 '① 편집(VisualEditor)' 과 본래 Wiki 의 문법을 사용해서 편집하는 '② 원본 편집' 으로 나뉩니다.

※ Wiki 의 문법은 링크(위키백과:위키 문법) 에서 참고하실 수 있으나 모든 문법을 사용 할 수 있는 것은 아닙니다.

특정 문법의 사용방법에 대해 Q&A 로 질문남겨주시면 답변 드리겠습니다.

편집 (시각편집기 VisualEditor)

시각편집기는 S2NANO Wiki를 시각적으로 편집할 수 있게 한 새로운 체제로 위키마크업을 배우지 않고도 기여할 수 있게 합니다.[1]

시각편집기 열기

Manual edit each paragraph.png

시각편집기로 문서를 편집하려면, 문서 상단의 '① 편집(VisualEditor)' 탭을 클릭하세요.

편집 창을 여는 것은 몇 초 가량 걸릴 수 있으며, 문서가 매우 길 경우에는 더욱 오래 걸립니다.

또한 각 문단의 "편집" 링크를 클릭하여 시각편집기를 열 수 있습니다.

시작하기: 시각편집기 툴바

Manual VisualEditor menubar.png
번호 하위 메뉴 설명
편집을 취소하거나 다시 실행합니다.
Manual VisualEditor menubar 2.png
문단 제목 풀다운 메뉴 : 문단 제목의 서식을 변경할 수 있도록 합니다. 문단 제목 스타일을 바꾸려면 커서를 해당 문단 제목에 둔 뒤에 본 메뉴의 항목을 선택합니다.

(텍스트를 블럭잡으실 필요는 없습니다.)

문단 제목은 "문단 제목"으로 설정되어 있고, 하위 문단은 "2단계 문단 제목", "3단계 문단 제목" 등입니다 텍스트에 대한 일반적 형식은 "문단"입니다.

단축키를 이용하여 바로 적용할 수 있습니다.

Manual VisualEditor menubar 3.png

형식 : "A"을 눌러 메뉴를 열어주세요.

  • "굵게" 항목(B)은 선택된 텍스트의 글씨를 굵게 합니다.
  • "기울임꼴" 항목(I)은 선택된 글자를 기울입니다.
  • "위 첨자" 항목(x2)은 선택된 글자 크기를 줄여주면서도 주변 텍스트보다 위치가 살짝 높도록, 즉 윗첨자를 쓰게 해 줍니다.
  • "아래 첨자" 항목(x2)은 선택된 글자 크기를 줄여주면서 주변 텍스트보다 위치가 살짝 낮도록, 즉 아랫첨자를 쓰게 해줍니다.
  • "취소선" 항목(S)은 선택된 텍스트를 가로지르는 취소선을 넣어줍니다.
  • "컴퓨터 코드" 항목(중괄호 묶음: {})은 전후에 위치한 다른 텍스트와 구분되도록 선택된 텍스트를 고정폭 폰트로 바꿔줍니다.
  • "밑줄" 항목(U)은 선택된 텍스트 밑에 직선을 넣어줍니다.
  • "언어" 항목(Aあ)은 선택된 텍스트에 언어(예: 프랑스어)와 읽는 방향(예:오른쪽에서 왼쪽)을 표시하게끔 해줍니다.
  • 마지막으로 "서식지우기"() 항목은 선택된 텍스트에 적용된 문자 양식(연결고리 포함)들을 모두 제거합니다.
링크 도구 : 사슬 모양 아이콘은 링크 도구입니다. 클릭하게 되면(대개 텍스트를 선택한 뒤에) 링크 대화창이 열립니다.
Manual VisualEditor menubar 5.png
기초 : Reference (문서 최하단) 에 들어갈 내용을 작성할 수 있습니다. 출처가 되는 자료의 주소나 내용을 입력합니다.

재사용 : 한번 사용한 Reference 를 다시 사용할 때 사용합니다. 기초 항목으로 작성된 목록이 나옵니다.

Manual VisualEditor menubar 6.png
점 목록 : Enter 입력 시 자동으로 점 목록이 적용됩니다. 작성 후 '들여쓰기 낮추기', '들여쓰기 높이기' 가 가능합니다.

숫자 목록 : Enter 입력 시 자동으로 숫자 목록이 적용됩니다. 작성 후 '들여쓰기 낮추기', '들여쓰기 높이기' 가 가능합니다.

Manual VisualEditor menubar 7.png
미디어 : 파일 형태로 업로드 된 미디어를 넣을 수 있습니다. (파일업로드)

틀 : Template 형태의 자료를 넣을 수 있습니다. 시각편집기 에서는 추천하지 않습니다.

요약 : 편집 시 안내 메시지를 작성할 수 있습니다. 마우스를 해당 느낌표 위에 올리면 문구가 나타납니다.

표 : 표를 작성할 수 있습니다. 표 작성 후 클릭하면 ⑧번 메뉴가 활성화 됩니다.

갤러리 : 미디어를 갤러리 형태로 넣을 수 있습니다. (미디어로 넣는것을 추천합니다.)

코드 상자 : 아래와 같이 상자 안에 넣어서 표시해 줍니다.

String test = "test";

각주 목록 : 각주(인용) 으로 넣은 목록을 표시해 줍니다.

Manual VisualEditor menubar 8.png
⑦ 번 메뉴 표 작성 후 내용입력 시 활성화 됩니다.

셀병합과 캡션, 삭제 기능이 있습니다.

특수 문자 입력이 가능합니다.
Manual VisualEditor menubar 10.png
도움말 팝업이 표시됩니다. [키보드 단축] 항목으로 단축키 목록을 볼 수 있습니다.
Manual VisualEditor menubar 11.png
문서 설정과 분류(Caterogy), 원본 편집으로 전환 등의 기능이 있습니다.
Manual VisualEditor menubar 12.png
문서 저장 을 할 수 있습니다. 문서 저장에 대한 요약을 남길 수 있습니다.

시각편집기의 문제

  • 불러오는 데 오래 걸림 — 장문의 복잡한 문서를 시각편집기로 불러오는 데 시간이 좀 걸릴 것입니다. 앞으로 훨씬 빨리 불러올 것이고 더 대용량 문서도 불러올 수 있을 것입니다.
  • 편집 기능이 불완전함 — 복잡한 양식의 일부 구성 요소 중 일부는 표시가 될 것이도 그 내용을 편집할 수 있으나 그 구조를 수정하거나 표나 정의 목록과 같은 새로운 항목을 추가할 수 없을 것입니다. 이 분야를 개선하는 데 우선순위를 두고 있습니다.
  • 브라우저 지원이 제한됨 — 지금 당장은 시각편집기가 파이어폭스, 크롬, 사파리, 인터넷 익스플로러 최신 버전에서만 작동합니다. 이들 브라우저의 옛 버전에서는 작동하지 않습니다. 오페라에 대한 지원은 제한되어 있습니다.
  • 위키문법 사용 제한됨 — 위키문법을 사용 할 수 없습니다. (예: '~~~~' 입력 시 안내 메시지 출력)
  • HTML 태그 사용 불가 — <div>, <span> 과 같은 HTML 태그 사용이 불가합니다.

원본 편집

기본으로 제공되는 Wiki 문법과 HTML 태그를 사용하여 편집이 가능합니다.

Main Page 와 같은 경우 '원본 편집' 으로 HTML 태그를 사용하여 작성하였습니다.

내용을 배경색이 들어간 박스 형태로 보여준다거나

폰트 사이즈을 지정할 수 있고,

작성자에 대한 정보도 손쉽게 남길 수 있습니다. (예 : Rioperm (talk) 18:49, 2 August 2016 (KST))

사용에 익숙해 진다면 시각편집기 보다 더 다양한 효과를 줄 수 있습니다.

사용가능한 HTML 태그

<div>내용</div>

네모 모양의 박스 형태를 넣을 수 있는 태그입니다.

기본속성은 가로,세로 가 자동으로 맞추어지며 색상은 없습니다.

각 속성에 대한 값을 적을 땐 ' : ' 의 다음에 값을 적고

여러 속성을 붙여서 사용 할때엔 ' ; '으로 구분하여 넣습니다.

사용 가능 속성(style)

가로 길이 - width : 10px

세로 길이 - height : 10px

테두리 - border : 1px solid red

배경 색 - background-color : skyblue

사용 예
입력 결과
<div style="width:150px; height:50px; border:1px solid red; background-color:green;"> 태그로 생성한 박스 </div>
태그로 생성한 박스
<font>내용</font>

글씨를 변경할 수 있는 태그입니다.

style 을 입력할 필요 없이 바로 속성값을 ' = ' 과 함께 입력합니다.

여러 속성 적용 시 띄어쓰기를 하고 다음 속성을 입력 하면 됩니다.

사용 가능 속성

크기 - size = 5

색상 - color = orange

사용 예
입력 결과
<font size=5 color=orange>바꿀폰트</font> 바꿀폰트

미디어 파일 업로드

Wiki 에서 미디어 (이미지) 파일을 사용하고자 할때는 먼저 업로드 한 뒤 사용해야 합니다.

미디어 파일 업로드 절차

  1. Sidebar 에 있는 파일올리기 에 접속
  2. 업로드 할 이미지 찾기
  3. 파일 선택
  4. 열기 버튼 클릭
    Manual file upload 1.png
  5. 파일명 확인 (사용될 문서명이나 관련정보를 상세 하게 적는 것이 찾기 쉽습니다.)
  6. 이미지 섬네일 확인
    Manual file upload 2.png
  7. 설명 및 요약 (생략 가능)
  8. 파일 올리기
  9. Manual file upload 3.png

업로드 한 이미지 사용하기(VisualEditor 기준)

  1. Menubar 에서 [넣기] - [미디어] 선택
  2. 업로드 한 파일명 으로 검색 (파일명을 ' _ ' 로 여러번 나누었을 경우 띄어쓰기로 쉽고 빠르게 검색이 가능합니다.)
    Manual file use 1.png
  3. 일반 설정
  4. 폰트 속성, 링크, 인용 사용 가능
  5. 고급 설정
  6. 위치, 형식, 크기 설정 (이미지 적용 후 이미지 클릭하여 마우스로 사이즈 조절이 가능합니다.)
  7. Manual file use 2.png

새로운 버전 올리기

한번 업로드 된 이미지가 변경되는 경우 새로운 버전으로 올릴 수 있습니다.

버전별로 관리되며 이전 버전으로 되돌아 갈 수 있습니다.

이미지 업로드 및 사용 특이사항

  1. 업로드 할 때 파일명을 자세하게 올려주세요. (1.png / image.bmp 등과 같은 이름 사용은 지양합니다.)
  2. 파일명의 띄어쓰기는 자동으로 밑줄 _ 이 붙습니다.
  3. 업로드 된 파일명에서 - 와 _ 구분으로 쉽게 검색이 가능합니다. (예: Manual_menubar.png 로 업로드 시 단어별 검색 가능 'manual', 'menubar' )
  4. 중복된 이미지를 업로드 할 수 있으나 파일명은 중복되지 않습니다.
  5. 이미지를 잘못 업로드 했을 시 새로운버전으로 올려주세요.
  6. 다른 사용자가 올린 이미지를 마음대로 수정하면 사용된 문서에서도 수정된 버전으로 보여지게 됩니다.

문서 보기

SideBar 문서

SideBar 문서보기

왼쪽에 SideBar 항목에서 원하는 문서를 선택하여 볼 수 있다.

문서 검색

문서 검색

오른쪽 상단에 검색기능을 활용하여 원하는 문서를 검색해서 볼 수 있다.

현재 S2NANO Wiki의 검색기능은 위키백과 같이 업그레이드 되어있지 않아 정확한 문서명이 입력되지 않을경우 검색이 안되는 항목이 존재한다.

모든 문서 목록

모든 문서 목록

정확한 문서명은 모르지만 위키에 저장되어 있는 문서를 보고 싶다면 모든 문서 목록 기능을 활용 할 수 있다.

왼쪽에 도구항목에서 특수 문서 목록을 선택하면 문서 목록이라는 카테고리에 모든 문서 목록 이라는 항목이 존재한다.

이 항목은 현재 위키에 저장되어 있는 모든 문서 목록을 보여주는 기능이다.

파일(이미지) 올리기

S2NANO Wiki의 기반이 되는 MediaWiki는 문서에서 이미지를 사용하기 위해서는 이미지 파일을 먼저 올려서 사용하여야 한다.

파일을 먼저 올리고 문서를 작성할 때 저장된 이미지를 불러오는 방식을 취한다.

위키 파일 올리기

왼쪽 메뉴에 도구 항목에서 파일 올리기를 선택하면 파일을 올릴수가 있다. 파일명은 동일 할 수 없으며 한번 올린 파일명에 대해서 파일과 설명 등을 수정가능하다.

현재는 png, gif, jpg, jpeg 4가지의 파일 형식을 지원하면 40mb의 파일까지 업로드 가능하다.

문서 생성 및 편집

신규 문서 생성

Wiki-manual 6.JPG

mediawiki는 문서 만들기라는 항목이 따로 없다. 일단 작성하고자 하는 문서의 제목을 검색하여 중복결과를 확인하고 없다면 이 위키에 " " 문서를 만드세요! 에서 " "를 선택하여 문서를 만들 수 있다.

문서 편집 및 문서 작성

mediawiki의 경우 위키문법이라는 마크업 형식의 언어를 사용해서 문서를 작성하는 것이 기본 기능이다.

현재 S2NANO Wiki의 경우 VisualEditor라는 플러그인을 설치하여 위키문법을 사용하지 않아도 작성 및 편집이 가능하다.

하지만, VisualEditor의 경우 현재 계속 개발되어지는 버전이기 때문에 일부 기능은 위키문법을 사용하는 일반편집에서 적용해야 하는 경우도 발생한다. 또한, 인터넷 익스플로어에서는 해당 기능이

원할하게 지원하지 않아 크로 브라우저를 통한 작업을 추천한다.

VisualEditor 사용

VisualEditor

VisualEditor 를 사용하고자 한다면 오른쪽 상단의 메뉴에서 읽기/편집/원본편집/역사보기/더 보기 항목에서 편집을 선택한다. 원본편집의 경우는 위키 기본 편집 기능을 사용한다.

VisualEditor의 경우 위와 같이 기존 문서와 똑같은 형태로 보여주기 때문에 위쪽에 도구를 활용하여 일반 문서 파일을 사용하듯이 사용하면 된다.

도구 메뉴를 설명하면,

    • 왼쪽부터 문단기능은 주제에 따라 문단을 나누고 목차를 만드는 도구이다.
    • 문단 옆에 A 항목은 글자의 굵기, 디자인 등을 편집하는 도구이다.
    • 사슬모양의 버튼은 링크를 연결하는 도구이다.
    • 인용 기능은 주석을 편집하는 기능이다. 새로운 주석을 생성하거나 생성한 주석을 사용할 수 있다.
    • 인용 옆에는 목록을 만드는 도구이다.
    • 넣기 항목은 이미지, 표 등을 넣는 도구이다.
    • 마지막 항목은 특수문자를 삽입하는 도구이다.
    • 오른쪽 상단에는 도움말 항목이 있어 어려운 부분은 확인하며 사용 가능하다.

이러한 도구들을 이용하여 문서를 작성하고 문서 저장을 선택하면 문서를 저장하고 완료한다.

다음 링크(바로가기)를 통해 NanoWiki 에서 사용하는 VisualEditor 의 기능을 더 자세하게 숙지 할 수 있다.

원본편집 도구

원본편집

VisualEditor의 몇가지 기능이 작동을 하지 않는 경우에는 원본편집을 선택하여 작성하여야 한다.

원본편집의 경우 위키문법을 사용하기 때문에 위키문법을 숙지하지 않고는 직관적으로 문서를 이해하기 어렵다. 적용된 기능을 확인하기 위해서는 미리 보기를 선택하여 확인 가능하다.

추가 Editor 플러그인을 설치하여 왼쪽 상단의 VisualEditor와 같은 도구 항목들이 있다. 이 도구항목들을 이용하면 위키문법이 익숙하지 않더라도 작성 할 수 있도록 도와준다.