<div id="readability-page-1" class="page">






<nav id="global-navigation">


</nav>
<main id="wrap" aria-hidden="false">

<div>






<article>
<header id="global-header">



<div>
<h2>confluence to tistory 제작-1</h2>
<ul>
<li role="text" aria-label="2021년 03월 23일 22시 09분에 작성된 글."><time datetime="2021-03-23T22:09">2021.03.23 22:09</time></li>
<li><a href="/category/%EA%B0%9C%EB%B0%9C%20%EC%9D%B4%EA%B2%83%EC%A0%80%EA%B2%83" aria-label="개발 이것저것">개발 이것저것</a></li>
</ul>
</div>


</header>
<div id="article"><hr data-ke-style="style1">
<h2 id="confluencetotistory제작-개발1일차" data-ke-size="size26">개발 1일차</h2>
<h3 id="confluencetotistory제작-단위목표" data-ke-size="size23">단위목표</h3>
<ul data-ke-list-type="disc">
<li>confluence api 조사</li>
<li>페이지, 스페이스 목록 정보 조회 api 확인</li>
<li>특정 페이지 <code>html</code> or <code>markdown</code> export api 확인</li>
</ul>
<h3 id="confluencetotistory제작-RESTAPI활용" data-ke-size="size23">REST API 활용</h3>
<ul data-ke-list-type="disc">
<li>인증 구현</li>
</ul>
<ol data-ke-list-type="disc">
<li>personal token 생성</li>
<li><code>&lt;로그인 이메일&gt;:&lt;토큰&gt;</code> 을 base64로 인코딩</li>
<li>Authorization 헤더에 Basic &lt;base64 인코딩 된 값&gt;을 추가하여 사용</li>
</ol>
<div data-hasbody="true" data-macro-id="64756d93-26a9-42dd-8630-4e1c74065daa" data-macro-name="code">
<pre data-syntaxhighlighter-params="brush: java; gutter: false; theme: Confluence" data-theme="Confluence"><code>curl -H "Authorization: Basic &lt;yourToken&gt;" https://{confluenceBaseUrl}/rest/api/content</code></pre>
</div>
<ul data-ke-list-type="disc">
<li>space 목록 확인</li>
</ul>
<div>
<table data-ke-style="style12" data-layout="default" data-ke-align="alignLeft"><colgroup><col><col><col></colgroup>
<tbody>
<tr>
<td><span><b>구분</b></span></td>
<td><span><b>정보</b></span></td>
<td><span><b>비고</b></span></td>
</tr>
<tr>
<td><span>API 경로</span></td>
<td><span><code>https://&lt;baseurl&gt;/wiki/rest/api/space</code></span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>매서드</span></td>
<td><span>GET</span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>호출 목적</span></td>
<td><span>space의 name, key 쌍 확인</span></td>
<td><span><br></span></td>
</tr>
</tbody>
</table>
</div>
<ul data-ke-list-type="disc">
<li>페이지 목록 조회</li>
</ul>
<div>
<table data-ke-style="style12" data-layout="default" data-ke-align="alignLeft"><colgroup><col><col><col></colgroup>
<tbody>
<tr>
<td><span><b>구분</b></span></td>
<td><span><b>정보</b></span></td>
<td><span><b>비고</b></span></td>
</tr>
<tr>
<td><span>API 경로</span></td>
<td><span><code>https://&lt;baseurl&gt;/wiki/rest/api/content</code></span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>매서드</span></td>
<td><span>GET</span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>Query 파라미터1</span></td>
<td><span>spaceKey</span></td>
<td><span>값: 조회할 space의 key</span></td>
</tr>
<tr>
<td><span>호출 목적</span></td>
<td><span>contents 들의 title 및 id 값 확인</span></td>
<td><span><br></span></td>
</tr>
</tbody>
</table>
</div>

<h3 id="confluencetotistory제작-xmlRPC" data-ke-size="size23">xmlRPC</h3>
<p data-ke-size="size16">페이지를 html로 랜더링해주는 REST API를 도저히 찾을수가 없어서, 관련 자료를 검색하던 중, xmlRPC API에는 관련 메서드가 있는듯 하여 찾아보았다. 이미 confluence Cloud에서는 5.5 버전에서 이미 지원이 종료된 API 기능 이었지만, API는 아직 동작 하지 않을까 싶어 시도해 보았으나, 한참 삽질 끝에 더 이상 동작하지 않는 API라는 것을 알게 되었다.</p>
<img src="https://i.ibb.co/d0fBGYB/bdf2b1341d2b.png" data-base-url="" data-height="171" data-image-src="" data-linked-resource-container-id="8880168" data-linked-resource-container-version="3" data-linked-resource-content-type="image/png" data-linked-resource-default-alias="image-20210317-161828.png" data-linked-resource-id="10518531" data-linked-resource-type="attachment" data-linked-resource-version="1" data-media-id="6e63df73-ad98-44f8-b8ce-83275ab0f920" data-media-type="file" data-unresolved-comment-count="0" data-width="496">

<hr data-ke-style="style1">
<h2 id="confluencetotistory제작-개발2일차" data-ke-size="size26">개발 2일차</h2>
<h3 id="confluencetotistory제작-신규단위목표" data-ke-size="size23">신규 단위목표</h3>
<ul data-ke-list-type="disc">
<li>이미지 추출 및 공개서버에 업로드 → html내 링크 정보 치환</li>
<li>테이블 테그 tistory 형식에 맞게 변경</li>
<li>codeBox tistory 형식에 맞게 변경 필요</li>
</ul>
<h3 id="confluencetotistory제작-드디어페이지html추출성공" data-ke-size="size23">드디어 페이지 html 추출 성공</h3>
<ul data-ke-list-type="disc">
<li>페이지 html export</li>
</ul>
<div>
<table data-ke-style="style12" data-layout="default" data-ke-align="alignLeft"><colgroup><col><col><col></colgroup>
<tbody>
<tr>
<td><span><b>구분</b></span></td>
<td><span><b>정보</b></span></td>
<td><span><b>비고</b></span></td>
</tr>
<tr>
<td><span>API 경로</span></td>
<td><span><code>https://&lt;baseurl&gt;/wiki/rest/api/content/&lt;pageId&gt;</code></span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>매서드</span></td>
<td><span>GET</span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>Query 파라미터1</span></td>
<td><span>expand</span></td>
<td><span>값: body.styled_view</span></td>
</tr>
<tr>
<td><span>호출 목적</span></td>
<td><span>페이지 html로 export</span></td>
<td><span><br></span></td>
</tr>
</tbody>
</table>
</div>
<h3 id="confluencetotistory제작-추출된페이지테스트등록" data-ke-size="size23">추출된 페이지 테스트 등록</h3>
<p data-ke-size="size16">추출된 html이 tistory 게시물로 등록되었을 때 바람직한 모양으로 출력되는지 테스트하기 위해서 테스트 게시물을 게시해 보았다. 눈에 띄는 문제점 두가지가 보였다.</p>
<ul data-ke-list-type="disc">
<li>표 디자인이 구림</li>
</ul>
<img src="https://i.ibb.co/mzpVHX9/7f73bd70f13c.png" data-base-url="" data-height="423" data-image-src="" data-linked-resource-container-id="8880168" data-linked-resource-container-version="3" data-linked-resource-content-type="image/png" data-linked-resource-default-alias="제목 없음.png" data-linked-resource-id="10551313" data-linked-resource-type="attachment" data-linked-resource-version="1" data-media-id="8ddd7ce4-6c1f-4cfb-b0d2-2b8ebe9011f4" data-media-type="file" data-unresolved-comment-count="0" data-width="799">
<ul data-ke-list-type="disc">
<li>코드박스 syntax highlight가 동작하지 않음</li>
</ul>
<img src="https://i.ibb.co/w02hLBF/9c5773bae964.png" data-base-url="" data-height="644" data-image-src="" data-linked-resource-container-id="8880168" data-linked-resource-container-version="3" data-linked-resource-content-type="image/png" data-linked-resource-default-alias="image-20210317-174604.png" data-linked-resource-id="10747932" data-linked-resource-type="attachment" data-linked-resource-version="1" data-media-id="2dd24dc2-4fba-4df2-acdf-b419d2537a02" data-media-type="file" data-unresolved-comment-count="0" data-width="980">
<p data-ke-size="size16">보이는 문제점 말고도 가장 치명적인 문제점이 하나 있는데, html내부에 삽입된 이미지가 confluence Cloud 서버내에 저장되어 링크가 걸려있었다. 당연히 로그인 통해 인가된 사용자만 접근하여 이미지를 로딩해 올 수 있었기 때문에, 블로그에 정상적으로 게시하기 위해서는 이미지를 별도 퍼블릭 서버에 업로드 한 뒤, 이미지 url 변경 사항을 반영하여 html을 다시 작성해 줘야 했다.</p>
<h3 id="confluencetotistory제작-코드블럭하이라이팅활성화" data-ke-size="size23">코드블럭 하이라이팅 활성화</h3>
<p data-ke-size="size16"><code>&lt;code&gt;</code> 블럭 추가로 해결</p>
<h3 id="confluencetotistory제작-표예쁘게" data-ke-size="size23">표 예쁘게</h3>
<p data-ke-size="size16"><code>th</code> 테그 모두 <code>td</code> 로 변경으로 해결</p>
<h3 id="confluencetotistory제작-이미지호스팅서버" data-ke-size="size23">이미지 호스팅 서버</h3>
<p data-ke-size="size16">무료이면서 가장 api 활용이 편리한 사이트를 찾다보니 <a href="https://imgbb.com/" rel="nofollow">imgbb</a> 라는 사이트를 찾게 되었다. API가 매우 간결하고 필요한 정보만 있어서 선택하였다.</p>
<ul data-ke-list-type="disc">
<li>이미지 업로드 API</li>
</ul>
<div>
<table data-ke-style="style12" data-layout="default" data-ke-align="alignLeft"><colgroup><col><col><col></colgroup>
<tbody>
<tr>
<td><span><b>구분</b></span></td>
<td><span><b>정보</b></span></td>
<td><span><b>비고</b></span></td>
</tr>
<tr>
<td><span>API 경로</span></td>
<td><span><code>https://api.imgbb.com/1/upload</code></span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>매서드</span></td>
<td><span>POST</span></td>
<td><span><br></span></td>
</tr>
<tr>
<td><span>Query 파라미터1</span></td>
<td><span>key</span></td>
<td><span>값: api token</span></td>
</tr>
<tr>
<td><span>Form 데이터</span></td>
<td><span>image</span></td>
<td><span>값: 이미지 바이너리</span></td>
</tr>
<tr>
<td><span>호출 목적</span></td>
<td><span>페이지 html로 export</span></td>
<td><span><br></span></td>
</tr>
</tbody>
</table>
</div>

<h2 id="confluencetotistory제작-참고자료" data-ke-size="size26">참고자료</h2>
<ul data-ke-list-type="disc">
<li>confluence restapi docs : <a href="https://developer.atlassian.com/server/confluence/confluence-server-rest-api/" rel="nofollow" data-card-appearance="inline">https://developer.atlassian.com/server/confluence/confluence-server-rest-api/</a></li>
<li>confluence server restapi docs : <a href="https://docs.atlassian.com/ConfluenceServer/rest/7.11.1/" rel="nofollow">https://docs.atlassian.com/ConfluenceServer/rest/7.11.1/</a></li>
<li>confluence cloud restapi docs : <a href="https://developer.atlassian.com/cloud/confluence/rest/intro/" rel="nofollow">https://developer.atlassian.com/cloud/confluence/rest/intro/</a></li>
<li>Atlassian community : <a href="https://community.atlassian.com/t5/Confluence-questions/Programmatically-Export-Space-to-HTML/qaq-p/374156" rel="nofollow">https://community.atlassian.com/t5/Confluence-questions/Programmatically-Export-Space-to-HTML/qaq-p/374156</a></li>
</ul>
</div>


<nav>
<ul>
<li></li>
<li></li>
<li></li>
</ul>
</nav>



















</article>


</div>
</main>

<nav id="pagination">

</nav>












	            
            
            
                        
                        
                                       
                                               
        
</div>

모두의 근삼이

염근철

개발 1일차 단위목표 confluence api 조사 페이지, 스페이스 목록 정보 조회 api 확인 특정 페이지 html or markdown export api 확인 REST API 활용 인증 구현 personal token 생성 : 을 base64로 인코딩 Authorization 헤더에 Basic 을 추가하여 사용 curl -H "Authorization: Basic " h..

confluence to tistory 제작-1

댓글