Site Generation
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
프로젝트 사이트 구성은 다음의 순서대로 합니다.
- site 서술자 작성하여 웹 사이트의 메뉴 구성하기.(src/site 디렉터리에 site.xml 파일을 작성합니다.)
- Maven이 제공하는 형식으로 프로젝트 문서 작성하기.(src/site 하위에 문서 형식에 따라 디렉토리를 구성하고, 그 밑에 파일들을 위치합니다.
) - 웹 사이트 배포하기.(mvn clean site-deploy
)
웹 사이트 배포할 서버 설정은 settings.xml에서 합니다.
프로젝트 웹 사이트 튜닝
- css 파일은 src/site/resources/css/site.css 작성.
- 템플릿 구성은 벨로서티 파일