[리눅스]PyQt 문서 파일 수정 및 링크

PyQt 문서 파일을 설치한 후 이 파일을 찾아보려고 하면 매우 힘들 것이다.

왜냐하면 메뉴에도 나타나지 않고 어디에 저장됐는지 알 수 없기 때문이다.

이 문서가 저장된 위치는 /usr/share/doc/python-qt4-doc 에 존재한다.

이 폴더에 있는 html 폴더에 모든 문서들이 저장 되어 있는데, 여기서 pyqt4ref.html 파일이 홈 파일이다.

이 파일을 링크해서 다른 곳에 두면 간단하게 찾아 볼 수 있다. 그리고 API 에 관련된 것은 이 파일을 열어서 아래로 내리다 보면 PyQt API Reference 라고 링크 되어 있다.

(링크를 하는 방법은 원하는 폴더에서 우클릭 한 다음 새로 만들기 > 위치로 향한 연결 을 클릭한 뒤 위 파일이 위치한 링크를 써주면 된다. 다만 이것은 쿠분투에서 링크를 다는 방법이므로 다른 배포판에서 링크를 다는 방법은 다른 설명을 참조 하길 바란다.)


이렇게 링크를 달아두면 필요할 때마다 API 를 찾아 볼 수 있다. 그런데 이 파일에 약간의 문제가 있다.

PyQt API Reference 에 들어가면 PyQt 의 클래스를 나열한 페이지가 보이는데, 그 페이지 좌측 상단에 있는 Home 버튼을 누르면 페이지가 없다고 나타나는 것이다. 그리고 Modules 페이지에 들어가서 Home 을 눌러도 역시 마찬가지이다.

원인은 링크가 상위 폴더에서 파일을 찾도록 해놨기 때문에 원하는 파일이 나오지 않는 것이다.

이것을 수정하는 방법은 이 문서들이 들어있는 html 폴더로 간 다음 classes.html 과 modules.html 을 수정하면 되는데, 루트 권한이 필요하므로 콘솔창을 열어서 루트 권한으로 에디터를 실행 시킨다.
(우분투나 쿠분투에서는 sudo gedit[또는 kate, kwrite] classes.html 이라고 치면 된다.)

그 다음 찾기 기능을 이용해서 pyqt4ref.html 단어를 찾는다. 그러면 앞쪽에서 링크 하나가 있는데 링크가 <a href="../pyqt4ref.html"> 로 되어 있다. 여기서 ../ 를 없애서 <a href="pyqt4ref.html"> 로 수정하면 된다. 그러면 정상적으로 링크가 작동하게 된다.