릴리스 이후 수정 사항

빌드번호: 0993

찾아보기 미리보기 화면이 열리지 않던 문제를 해결했습니다. 화면을 그리는 스크립트가 시작 단계에서 멈춰 아무것도 표시되지 않았습니다.

브랜치 검토와 풀 리퀘스트 미리보기, 라이브러리 내려받기 화면도 같은 이유로 열리지 않았습니다.

아파치 더비를 사용한다면 H2로 옮기세요

아파치 더비를 데이터베이스로 사용하고 있으면 관리자에게 알림을 보냅니다. 상태 점검 화면의 데이터베이스 항목에도 함께 표시합니다. 매뉴얼웍스 7.0 버전부터는 아파치 더비를 지원하지 않을 예정이므로 H2로 옮기기를 권장합니다. 옮기는 방법은 아파치 더비에서 H2로 데이터베이스 옮기기를 참고합니다.

다음을 참고합니다.

매뉴얼웍스에 데이터베이스를 옮기는 기능이 들어 있어서 데이터를 직접 내보내고 들여올 필요가 없습니다.
옮긴 다음에는 server.xml에서 데이터베이스를 직접 바꿉니다.
아파치 더비 데이터는 그대로 남습니다. 문제가 생기면 server.xml만 되돌려서 예전 상태로 돌아갈 수 있습니다.

MCP로 장 제목 변경하기

MCP에 장 제목을 변경하는 update_chapter_title 도구를 추가했습니다. 접근 가능한 장의 아이디와 새 제목을 입력하면 제목을 변경할 수 있습니다.

태스크

태스크에 개인 메모 남기기

태스크 화면에 메모 탭을 추가했습니다. 태스크와 관련해 따로 기록할 내용을 1메모로 남길 수 있으며, 작성한 메모는 본인만 볼 수 있습니다.

MCP에서도 create_answer 도구의 유형을 NOTE로 설정해 메모를 작성할 수 있습니다. get_task 도구로 태스크를 가져오면 자신이 작성한 메모도 notes 항목에서 함께 확인할 수 있습니다.

MCP로 태스크 카테고리 바꾸기

MCP에 get_categories 도구를 추가했습니다. 접근할 수 있는 태스크 카테고리를 부모와 자식 관계 그대로 가져옵니다.
update_categories 도구로 태스크에 카테고리를 붙이거나 뗄 수 있습니다. 여러 개를 한 번에 처리하며, 이미 붙어 있는 것을 다시 붙이거나 붙지 않은 것을 떼면 그대로 둡니다.
get_task 도구의 응답에 카테고리와 마일스톤을 넣었습니다. 태스크에 무엇이 붙어 있는지 확인할 수 있습니다.

사이트에서 마크다운 파일이 없는 링크 삭제하기

<도구 | 사이트> 메뉴의 <1마크다운 없는 링크 삭제> 링크를 실행하면 크롤링해 둔 링크 가운데 마크다운 파일을 가져올 수 없는 것을 찾아 삭제합니다. 책을 만들 때와 같은 기준으로 확인하므로 정리한 뒤에는 장을 만들 수 있는 링크만 남습니다.

다음을 참고합니다.

링크마다 마크다운 파일을 확인하므로 링크가 많으면 시간이 걸립니다. 진행 상황을 진행률로 보여줍니다.
마크다운 주소가 없는 링크와 이미 장을 만든 링크는 삭제하지 않습니다. 시간 초과처럼 확인하지 못한 링크도 그대로 둡니다.

문서에서 뉴스레터 구독 받기

책, 짧은 문서, 블로그, 비디오의 문서 만들기 또는 수정 화면의 옵션에서 “뉴스레터 구독을 사용합니다.”를 선택하면 문서에 뉴스레터 구독 입력란을 표시합니다. 이 옵션의 기본값은 사용하지 않음입니다.

방문자는 웹 뷰어의 장, 블로그 게시물 또는 비디오 클립 아래에서 이름과 이메일 주소를 입력해 뉴스레터를 구독할 수 있습니다.

AI가 문서를 읽을 수 있도록 개선

매뉴얼웍스는 요청의 User-Agent를 보고 수집기라고 판단하면 자바스크립트 없이 본문이 들어 있는 정적 HTML을 내려보냅니다. 그런데 이용자가 AI에 주소를 붙여넣었을 때 동작하는 수집기는 이름에 bot이 없어 인식하지 못했습니다. ChatGPT나 제미나이가 주소는 찾았지만 내용을 읽지 못하는 원인이었습니다.

주요 AI 수집기를 시스템 패턴에 넣었습니다. 따로 설정하지 않아도 다음을 인식합니다.

ChatGPT-User, Claude-User, Perplexity-User
Google-Agent, GoogleAgent-URLContext, Google-GeminiNotebook, GoogleOther
meta-externalagent, meta-externalfetcher
MistralAI-User, MistralAI-Index, MistralAI-Training
Grok이 사용하는 헤드리스 크롬(HeadlessChrome)

AI는 아니지만 이용자 요청에 따라 페이지를 가져오는 Google-InspectionTool, Google-Read-Aloud, Google-Pinpoint, GoogleMessages, FeedFetcher-Google도 함께 넣었습니다.

수집기가 다녀간 것도 방문 통계에 남습니다. 문서 루트를 요청하면 문서로, 특정 장을 요청하면 그 장으로 기록합니다. 봇으로 분류하므로 통계의 봇 필터로 사람의 방문과 나눠 볼 수 있고, 수집기 접근을 막은 문서는 기록하지 않습니다.

자세한 사항은 AI를 위한 웹 크롤러 설정하기를 참고합니다.

문서와 부의 차례를 마크다운으로 보기

공개한 문서 주소 끝에 .md를 붙이면 문서 제목과 장 차례를 마크다운으로 보여줍니다. 부의 주소 끝에 .md를 붙이면 부 제목과 그 아래에 속한 장의 차례를 보여줍니다.

차례의 각 항목은 해당 장의 마크다운 주소로 연결됩니다. 웹에서 제외한 장은 차례에도 표시하지 않으며, 태그로 발행한 문서는 태그 시점의 구조와 제목, 별칭을 사용합니다.

자동으로 만들어지는 사용자의 권한 정하기

LDAP이나 OAuth 등의 외부 인증으로 처음 로그인한 사용자에게 부여할 권한을 지정합니다. 이전에는 항상 글 쓰기 권한을 부여했고 바꿀 방법이 없었습니다. 콘솔에서 다음 명령어를 실행합니다.

set-preference -name DEFAULT_ROLE -value reader

다음을 참고합니다.

여러 권한을 주려면 reader;translator처럼 세미콜론으로 구분합니다. admin, editor, writer, translator, reader를 지정할 수 있습니다.
그 밖의 값을 넣으면 설정하지 않고 오류를 보여줍니다. 오타 때문에 의도와 다른 권한이 부여되지 않도록 합니다.
LDAP은 권한 정보를 넘기지 않으므로 항상 이 설정을 사용합니다. OAuth 2.0은 인증 서버가 roles를 3rabbitz로 보내거나 비워 두었을 때 사용합니다.
사용자 수 라이선스 제한에 걸리면 글 읽기 권한만 부여합니다.
설정하지 않으면 종전과 똑같이 동작합니다.
이미 만들어진 사용자에게는 적용하지 않습니다. 관리자가 바꾼 권한은 다시 로그인해도 그대로 유지됩니다.

수정 사항

Apache Commons IO 2.22.0 버전으로 업데이트했습니다.
웹 뷰어에서 부로 연결된 링크를 미리보기하면 그 부에 속한 장의 차례를 함께 보여줍니다. 이전에는 부에 내용이 없어서 제목만 보였습니다.
데이터베이스를 옮길 때 스키마를 만들지 못하면 실패한 질의 수를 알리고 멈춥니다. 옮길 데이터베이스에 데이터가 들어 있으면 비워야 할 표를, 옮기지 못한 표가 있으면 그 수를 알립니다. 이전에는 로그를 봐야 알 수 있었습니다.
리눅스에서 매뉴얼웍스를 다시 시작하면 포트를 잡지 못해 기동에 실패하던 문제를 수정했습니다. 종료를 기다리지 않고 다음 프로세스를 띄웠습니다. 이미 설치한 곳은 업데이트로 바뀌지 않으므로 bin 디렉터리의 startup.sh와 shutdown.sh를 직접 교체해야 합니다.
웹 크롤러 패턴에 대문자가 섞여 있으면 인식하지 못하던 문제를 수정했습니다. 이제 저장할 때 패턴을 소문자로 맞춥니다. 시스템 패턴인 findLinks도 같은 이유로 동작하지 않고 있었습니다.
페이지 응답에 Cache-Control 헤더가 두 줄로 나가던 문제를 수정했습니다. 3rabbitz.cache_control 시스템 속성으로 값을 바꿔도 앞서 넣은 no-cache가 남아 캐시 정책을 온전히 제어할 수 없었습니다. 이제 설정한 값 하나만 나갑니다.

해결한 버그

사용자 스타일 유형의 키가 길면 그 스타일로 단락을 바꿀 때 오류가 나던 문제를 수정했습니다. 이제 만들기 화면에서 쓸 수 있는 키 길이를 안내하고, 넘으면 만들지 않습니다. 이미 만들어 둔 유형은 삭제한 뒤 짧은 키로 다시 만듭니다.
디자인 페이지와 PDF 페이지 레이아웃의 텍스트에 < 기호를 넣으면 PDF에서 그 뒤의 내용이 보이지 않던 문제를 수정했습니다. 같은 이유로 워드 파일이 깨지던 문제도 함께 고쳤습니다.
장 주소 끝에 .md를 붙였을 때 여러 마디로 구성된 공개 링크에서 404 오류가 나던 문제를 수정했습니다. 태그로 발행한 문서는 태그 시점의 장과 별칭을 사용합니다.
차례 숨기기가 제목1로 지정된 장과 짧은 문서에서 웹 뷰어의 오른쪽 메뉴가 보이지 않던 문제를 수정했습니다. 차례에 제목만 있어 제목1부터 숨기면 통째로 비었습니다. 선택지는 6.0.22에서 없앴고 예전에 지정해 둔 값은 업데이트할 때 지웁니다. 책은 차례에 장이 남으므로 그대로 둡니다.
내려받은 파일의 이름이 깨지던 문제를 수정했습니다. 파일 이름을 한글로 전달하는 형식을 웹 브라우저 쪽에서 해석하지 못했습니다. 방문 통계와 문서 내보내기, 용어집 내려받기 등 내려받는 모든 파일에 해당합니다.
태스크의 에디터에서 한 문단 안의 줄 바꿈이 사라지던 문제를 수정했습니다. Shift + Enter로 넣은 줄 바꿈과 붙여넣은 줄 바꿈이 저장하면서 지워졌습니다. 이미 저장된 내용은 되살릴 수 없으므로 다시 입력해야 합니다.
테스크의 에디터에서 여러 줄 텍스트를 붙여넣으면 빈 줄을 기준으로 문단을 나눕니다. 한 문단 안의 줄 바꿈은 그대로 둡니다. 이전에는 붙여넣은 내용이 모두 한 문단이 되었습니다.
태스크의 에디터에서 웹 페이지에서 코드를 복사해 붙여넣으면 꺾쇠 안의 내용이 사라지던 문제를 수정했습니다. 코드 단락과 블록 인용구, 제목에 붙여넣을 때 해당합니다.
패키지에 들어가는 셸 스크립트의 줄 바꿈이 윈도우 형식이 되어 리눅스에서 실행되지 않을 수 있던 문제를 수정했습니다. 빌드하는 컴퓨터에 따라 달라졌습니다.
소프트웨어 업데이트에서 파일 올리기와 내려받기, 취소를 동시에 실행하면 올리는 중인 파일이나 작업 디렉터리가 사라지던 문제를 수정했습니다. 이제 한 번에 하나만 진행합니다. 받다 만 파일을 정상 업데이트 파일로 보여주던 문제도 함께 고쳤습니다.
web.xml의 보안 제약이 효과가 없어 GET과 POST 외의 HTTP 메서드가 열려 있던 문제를 수정했습니다. KEEP_WEB_XML을 설정해 web.xml을 그대로 두는 곳은 업데이트할 때 제품이 넣어 둔 블록만 찾아서 고칩니다.
로그 파일을 압축할 때 로그가 사라질 수 있던 문제를 수정했습니다. 같은 달의 압축 파일이 이미 있으면 압축하지 않으면서 원본 로그를 지웠습니다.
서버를 멈출 때 작업 스레드가 남아 메모리 누수 경고가 기록되던 문제를 수정했습니다.
업데이트 서버에 접속하지 못할 때와 제품에서 없앤 설정이 데이터베이스에 남아 있을 때 오류처럼 보이는 로그가 길게 남던 문제를 수정했습니다.