favicon - epydoc のファビコンを変更する - 方法は?

Question

すべてが問題です: epydoc の生成された html ページの favicon を変更するにはどうすればよいですか?

注：cssコンテンツをカスタマイズする方法を見ましたが、出力htmlファイルのカスタマイズについては何も知りませんでした...

どうもありがとう。

Answer 1

さて、（私自身と）ちょっとしたブレインストーミングをした後、私は方法を見つけました：

--navlinkオプションを使用してepydoc（最初はナビゲーションバーのプロジェクトのリンクをカスタマイズするように設計されています）を使用してHTMLを挿入できるため、javascriptのトリックを使用して、ドキュメントのタグに次のものを動的に追加しました。

これがjavascriptコードです：

var link = parent.document.createElement('link'); 
link.id = 'dynamic-favicon'; 
link.type = 'image/png'; 
link.rel = 'shortcut icon'; 
link.href = '../logo-fav.png'; parent.document.head.appendChild(link);
parent.document.head = parent.document.head || 
                           parent.document.getElementsByTagName('head')[0];

そしてここに完全なepydocコマンドラインがあります：

epydoc -v --name "My Project" -o ./html \
--css epydoc.css --url http://www.my-project.org --inheritance listed \
--graph all --no-private --docformat epytext \
    --navlink "<a href=\"http://www.my-project.org\"><img src=\"../logo.png\" style=\"margin:10px;\" /></a>
        <script>
            var link = parent.document.createElement('link'); 
            link.id = 'dynamic-favicon'; 
            link.type = 'image/png'; 
            link.rel = 'shortcut icon'; 
            link.href = '../logo-fav.png'; 
            parent.document.head.appendChild(link); 
            parent.document.head = parent.document.head || parent.document.getElementsByTagName('head')[0];
        </script>
        " \
    my_py_module

これを使用してドキュメント全体をカスタマイズできますが、それでもハッキーです。epydocのような成熟したツールでいくつかのテンプレートを使用する方法がないのはまだ奇妙です...