Whiteship's Note


Site Generation

Build/Maven : 2007.12.03 20:57


Maven이 프로젝트 웹 사이트 관리에 주는 장점.
  • 프로젝트 상태 리포트와 그 밖에 코드와 관련된 문서를 작성해 준다.
  • 웹 사이트 네비게이션 엘리먼트 관리
  • 소스-문서 포맷으로 웹 사이트 컨텐츠 랜더링
  • XHTML이나 PDF와 같이 다양한 형태로 컨텐츠로  배포 가능
  • 프로젝트 바이너리 파일에 포함시킬 포터블한 문서 생성.
mvn site:run

위 명령을 실행한 뒤, http://localhost:8080 으로 접속하면 Maven이 생성해주는 프로젝트 웹 사이트를 볼 수 있습니다.

사용자 또는 개발자들이 프로젝트 웹 사이트에서 참조하고자 하는 정보는 다음과 같습니다.
  • feature lists
  • screenshots of the application in action
  • project news and release changelogs
  • downloads for released distributions
  • installation instructions
  • usage and configuration how-to's
  • architectural diagrams
  • frequently asked questions
  • forums
프로젝트 사이트 구성은 다음의 순서대로 합니다.
  1. site 서술자 작성하여 웹 사이트의 메뉴 구성하기.(src/site 디렉터리에 site.xml 파일을 작성합니다.)
  2. Maven이 제공하는 형식으로 프로젝트 문서 작성하기.(src/site 하위에 문서 형식에 따라 디렉토리를 구성하고, 그 밑에 파일들을 위치합니다. )
  3. 웹 사이트 배포하기.(mvn clean site-deploy )
웹 사이트 배포할 서버 설정은 settings.xml에서 합니다.

프로젝트 웹 사이트 튜닝
- css 파일은 src/site/resources/css/site.css 작성.
- 템플릿 구성은 벨로서티 파일


'Build > Maven' 카테고리의 다른 글

Managed dependency는 무슨 뜻인가요?  (0) 2008.04.14
Maven을 쓴다고 해서 종속성을 안중에서 Out 시킬 수 있느냐?  (2) 2008.03.03
Archetype 만들기  (4) 2007.12.21
Assemblies  (0) 2007.12.04
Maven 괜찮은데~  (0) 2007.12.04
Site Generation  (0) 2007.12.03
http://mvnrepository.com/  (0) 2007.12.02
Profile  (0) 2007.11.30
Archetype  (0) 2007.11.29
Plugin  (4) 2007.11.28
Build Lifecycle(site)  (0) 2007.11.27
top

TAG maven, site

Write a comment.


Build Lifecycle(site)

Build/Maven : 2007.11.27 12:16


site

지금까지 생성된 파일(구조물 artifact)을 저장소에 빌드하고 위치시키는 과정에 대해 살펴봤습니다. 그러나 Maven은 단순히 코드를 생성하는 것보다 뭔가를 더 해줍니다, 프로젝트에 대한 리포트나 다큐먼트를 생성해주기도 합니다. 그런 일들을 해주는 site는 다음과 같은 Phase로 구성되어있습니다.

pre-site
site - site와 보고서를 생성
post-site
site-depoly - site를 원격 서버에 배포

site 라이프사이클에 묶여있는 기본 Goal은 다음과 같습니다.

site - site:site
site-deploy - site:deploy

default 빌드 라이프사이클과 다르게, 패키징 타입에 따라 달라지는 것이 없습니다. 이전에도 이 Phase를 사용해 본적이 있습니다.

mvn site

이것에 대해서는 나중에 다른 챕터에 다룹니다.

'Build > Maven' 카테고리의 다른 글

Site Generation  (0) 2007.12.03
http://mvnrepository.com/  (0) 2007.12.02
Profile  (0) 2007.11.30
Archetype  (0) 2007.11.29
Plugin  (4) 2007.11.28
Build Lifecycle(site)  (0) 2007.11.27
Build Lifecycle(default 자세히)  (0) 2007.11.27
Build Lifecycle(default)  (0) 2007.11.27
Build Lifecycle(clean)  (2) 2007.11.27
POM  (0) 2007.11.26
mvn site  (0) 2007.11.20
top

Write a comment.


mvn site

Build/Maven : 2007.11.20 10:07


Maven에서 제공하는 빌드 라이프사이클 단계Phase 중에서 site를 사용하면, 프로젝트에 대한 정보를 보여주는 html 파일을 작성해 줍니다. 참고로 빌드 라이프사이클 단계를 실행 할 때마다 관련된 플러그인과 해당 플러그인이 참조하는 jar 파일들을 다운로드 하느라 다소 시간이 소요됩니다.
사용자 삽입 이미지

실행을 마치고, 프로젝트를 다시로딩Refresh 해주면, target 폴더에 다수의 html 파일이 생성된 것을 확인할 수 있습니다. 그 중에서 index.html을 열어보겠습니다.

사용자 삽입 이미지
첫 화면은 위와 같습니다. 왼쪽의 메뉴를 보니, 공부할 것이 태산 같다는 생각이 듭니다. Continuous Integration. 와우.. CI 툴과 연동하면, 그 결과를 이 페이지에서 참조할 수 있을 것 같습니다. Dependencies
 
사용자 삽입 이미지
Dependencies를 보시면, 현재 JUnit만 정의해 두었기 때문에, 썰렁하지만 추이적 종속성과 그 모습을 그래프로 볼 수 있다는 사실이 재밌어 보입니다.

이 밖에도, 이슈 트래킹, 메일링 리스트, 프로젝트 요약정보, 프로젝트 팀, 소스 저장소 등의 메뉴가 있습니다. 미루어 짐작해볼 때, CI도 설치하고, SVN도 설치하고, 이슈트래커도 설치하여 Maven에서 참조할 수 있게 설정해두면 정말 좋겠네요.

'Build > Maven' 카테고리의 다른 글

Build Lifecycle(site)  (0) 2007.11.27
Build Lifecycle(default 자세히)  (0) 2007.11.27
Build Lifecycle(default)  (0) 2007.11.27
Build Lifecycle(clean)  (2) 2007.11.27
POM  (0) 2007.11.26
mvn site  (0) 2007.11.20
Maven 용어 3  (0) 2007.11.19
Maven 용어 2  (0) 2007.11.19
Maven 용어 1  (2) 2007.11.16
Maven으로 프로젝트 생성하기  (0) 2007.11.15
Maven 공부시작  (6) 2007.11.15
top

TAG maven, site

Write a comment.