[{TableOfContents }]
----

안녕하세요, JSPWiki 한글문서에 오신것을 환영합니다. 다른 릴리즈에 대한 주요 문서는 JSPWiki Documentation Wiki에 있으며, 아래의 릴리즈들은 각각의 문서가 별도로 존재합니다.(본 문서는 현재 작성 중 입니다.) * [JSPWiki 2.2.x|http://doc.jspwiki.org/2.2].

각설하고, 여러분이 읽어볼 만한 근사한 내용들이 여기에 있습니다.

!처음 사용자

* [위키란 무엇인가?|Project Tattooine|OneMinuteWiki]

!JSPWiki는 무엇인가?

* [JSPWiki의 특징|JSPWikiFeatures] - ''이 위키의 특징들은 무엇인가?''
* [다운로드 및 설치|JSPWikiDownload]
* [JSPWiki 자주 묻는 질문과 답변|JSPWikiFAQ] - ''이 사이트와 소프트웨어에 대한 질문들''
* [JSPWiki 플러그인|JSPWikiPlugins]

!일반 사용자

* [문서 작성 규칙|Text formatting rules] - ''JSPWiki에서 사용되는 문서 작성법에 대한 자세한 설명(영문)''
* [문서 작성 규칙 한글|TextformattingrulesKorean] - __JSPWiki 작성규칙 한글 번역(하다가 말았음)__
* [위키 에티켓]
* [말로만 설명하지 말고 보여줘|DontTellMeShowMe] - ''명령과 그 결과를 직접 확인하세요''

!사이트 관리자
* [Deployment] - tips for deploying JSPWiki in a production environment (docs in progress!)
* [JSPWiki태그|JSPWikiTags] - JSPWiki가 지원하는 [JSP 태그들|JSP tags].
* [새로운 템플릿 만들기|HowToCreateANewTemplate] - a work in progress step by step tutorial on how to create new templates.
* [프린터 출력용 페이지 만들기|HowToCreatePrinterFriendlyPage] - if you only have 5 minutes, this is the quick (maybe dirty) patch
* [JSPWiki 팁들|JSPWiki tips] - tips about setting up RSS feed, left menu and other configuration issues
* [Security 2.3] - security features of the 2.x.''x'' release
* [FAQCaching] - how to manage JSPWiki caching features

!개발자

* [On-line javadocs|http://www.ecyrd.com/~jalkanen/JSPWiki/javadoc]
* [JSPWikiDevelopment] - A big collection of stuff.
* [JSPWikiDesign]

!버그 보고하기 및 아이디어

* [버그 보고하기|SubmitBugReport]
* [보고된 버그들|BugReports]
* [아이디어|Ideas]
* [2.2릴리즈에 대한 토론|Release2.2Discussion]

!관련 카테고리들

* [Category - Documentation]
* [Category - Official Documentation]


!다른 언어로 작성된 문서
* [English Documentation|JSP Wiki Documentation|1.3.6.1.5.5.7.3.2]
* [中文文档]
----

[CategoryDocumentation]


----

한글URL이 제대로 지원되는 방법이 없을까요?

지금까지 삽질한거 생각하면...휴...

검색은 lucene 을 1.9.1 로 바꿔서 넣거나 lucene 이 아닌 기본 검색 방법을 사용하면 해결되고(jspwiki.properties),

Search.jsp 에 request.getParamter() 를 new String(request.getParamter.getBytes("ISO-8859-1"), "UTF-8") 로 변경함으로써 UTF-8 환경에서 제대로 한글 검색이 되게 할 수 있는데...

UTL 은 아무리 해도 안되는군요...

정말 희안한건...jspwiki.com 에서는 제대로 된다는 것입니다.

도대체 뭐가 다른건지...

jspwiki.urlConstructor = ShortURLConstructor 도 주석제거해보고...별별 짓을 다해봤는데...흑흑...

Linux, FreeBSD 에서 테스트 해봤습니다.

혹시 OS 의 기본 LANG 등의 설정이 잘못되어서 그런걸까요...

--AnonymousCoward, 12-Jul-2006

----
I also have a problem using Korean characters in JSPWiki. I can't create a page or search a page with Korean pagename. Is there anyone who solves this problem? I use most recent version 2.4.71 with tomcat on a Korean windows. any help will be great.

저도 한글 사용에 애로 사항이 있습니다. 아직 Tomcat 이나, 소스 코드 내부의 charset 설정 등을 건드리지 않은 상태에서 한글 페이지 생성 및 검색이 안됩니다. 어떤거를 고쳐주면 좋을까요? --yangwook, 23-Oct-2006

----

한글 문제에 대해서 아래의 페이지에서 같이 의견을 모아봅시다

[한글화지원|KoreanSupport]


----

中文测试

--AnonymousCoward, 02-Mar-2007

\\
--122.101.138.108, 25 Sep 07



----

톰캣 설정 문제입니다.
server.xml의 Connector에 URIEncoding="UTF-8"을 추가해 주세요.
{{{
	<Connector port="48080"
               maxThreads="15" minSpareThreads="2" maxSpareThreads="7"
               enableLookups="false" redirectPort="48443" acceptCount="100"
               debug="0" connectionTimeout="20000"
               disableUploadTimeout="true"
               URIEncoding="UTF-8"/>
}}}

--AnonymousCoward, 04-Jul-2008

----
한글 파일 다운로드 시 깨짐 방지\\
/src/com/ecyrd/jspwiki/attachment/AttachmentServlet.java 300 Line 변경\\

%%prettify 
{{{
                String userAgent = req.getHeader("User-Agent");
                if (userAgent.indexOf("MSIE 5.5") > -1) { // Under IE 5.5
                    res.setHeader("Content-Disposition", "filename=\"" + TextUtil.urlEncodeUTF8( att.getFileName() ) + "\";");
                } else if (userAgent.indexOf("MSIE") > -1) { // Over IE 6.0
                    res.setHeader("Content-Disposition", "attachment; filename=\"" + TextUtil.urlEncodeUTF8( att.getFileName() ) + "\";");
                } else { // Other browser like mozilla
                    res.setHeader("Content-Disposition", "attachment; filename=\"" + new String( att.getFileName().getBytes( "UTF-8" ), "latin1" ) + "\";");
                }
}}}
/%

--combine, 2009-08-13
----
한글 분석기 설치\\
http://cafe.naver.com/korlucene 분석기 받음\\
lucene.jar, lucene-highlighter.jar 삭제 후 최신버전 lucene-core-2.4.1.jar, lucene-highlighter-2.4.1.jar\\
\\
PDF, Word, PPT 등 검색을 위한 /src/com/ecyrd/jspwiki/search/LuceneSearchProvider.java 파일 수정\\
참조: http://www.jspwiki.org/wiki/MaciejR\\
%%prettify 
{{{
    protected String getAttachmentContent( Attachment att )
    {
        AttachmentManager mgr = m_engine.getAttachmentManager();
        //FIXME: Add attachment plugin structure

        String filename = att.getFileName();

        /*if(filename.endsWith(".txt") ||
           filename.endsWith(".xml") ||
           filename.endsWith(".ini") ||
           filename.endsWith(".html"))
        {*/
            InputStream attStream;
            
            try 
            {
				ContentProvider contentProvider = ContentProviderFactory.getProvider(filename);
				
                attStream = mgr.getAttachmentStream( att );
                
                log.debug("Getting content of " + filename);

				if(contentProvider != null) {
					log.debug("Attachment provider: " + contentProvider);
					
					contentProvider.setContents(attStream);
				
					String readableAttachment = contentProvider.getReadableContents();
				
					attStream.close();
					return readableAttachment;
					
				}
				
                StringWriter sout = new StringWriter();
                FileUtil.copyContents( new InputStreamReader(attStream), sout );

                attStream.close();
                sout.close();

                return sout.toString();
            } 
            catch (ProviderException e) 
            {
                log.error("Attachment cannot be loaded", e);
                return null;
            } 
            catch (IOException e) 
            {
                log.error("Attachment cannot be loaded", e);
                return null;
            }
        //}

        //return null;
    }
}}}
/%

--combine, 2009-08-13

----
* 한글파일다운로드문제 해결방법 입니다. (__JSPWiki-2.8.3-src 버전__)
* 원인은 다운로드는 get방식으로 호출을 합니다. 내부적으로 request.getPathInfo(); 함수를 이용하여 다운로드 파일의 정보를 얻는데, 여기서 인코딩이 깨지는 형상이 발생하였습니다.
* __해결은 com.ecyrd.jspwiki.url.DefaultURLConstructor 클래스의 208라인에있는 parsePage 함수를 수정했습니다.__
{{{{
    public String parsePage( String context,
                             HttpServletRequest request,
                             String encoding )
        throws UnsupportedEncodingException
    {
        String pagereq = request.getParameter( "page" );

        if( context.equals(WikiContext.ATTACH) )
        {
            pagereq = parsePageFromURL( request, encoding );
            //해당부분 추가
            if (pagereq != null) {
            	pagereq = new String(pagereq.getBytes("ISO-8859-1"), "UTF-8");
            }
            //추가 끝
        }

        return pagereq;
    }
}}}}
\\
--[insford|http://www.insford.com/wiki/Wiki.jsp?page=JspWiki_%ED%95%9C%EA%B8%80%EB%AC%B8%EC%A0%9C], 2010-02-07