1

私は小さなおもちゃのプロジェクトに取り組んでおり、そのプロジェクトはどんどんリリースされています。これまで、ドキュメントは、プロジェクト用に設定した wordpress ブログの一連のページに過ぎませんでした。ただし、時間が経つにつれて新しいリリースが出てくるので、最新のリリースに合わせてオンライン ドキュメントを更新する必要があります。

残念ながら、そうすると、ドキュメント ページが最新バージョンに更新されるため、以前のリリースのドキュメントは「消えて」しまいます。そのため、ドキュメントをリリース パッケージに含め、最新のドキュメントをオンラインで利用できるようにしておくことにしました。ウェブページも。

些細なアイデアは、WordPress ページから現在のドキュメントを wget し、それらを svn に保存して、したがってリリース パッケージに保存し、新しいリリースごとに手順を繰り返すことです。残念ながら、取得した HTML を手動でハックしてリンクを修正する必要があります (または、Wordpress をハックして BASE を使用し、HTML コードを簡単に再配置できるようにする必要がありますが、これはやりたくないことです)。

同時に持つ要件をどのように処理すればよいですか:

  1. ダウンロード可能なパッケージに含まれる適切なバージョンのユーザーが閲覧可能なドキュメント
  2. 最新のドキュメントはオンラインで入手できます (そして、私の Web テーマで適切にスタイル設定されています)
  3. svn と実際のオンライン コンテンツとの間で同期を維持します (ワードプレス、またはワードプレスのセットアップにうまく適合するその他のもの)。
  4. 使いやすい

ありがとう

編集：より多くの答えを引き出すことができるかどうかを確認するために賞金を開始しました. これはかなり重要な問題だと思いますので、今後の読者のために複数のヒントや意見をいただければ幸いです。

4

5 に答える 5

2

WGet は、ドキュメント内のすべてのリンクを変換できます。convert-links オプションを参照してください。

http://www.gnu.org/software/wget/manual/html_node/Advanced-Usage.html

これを他の方法と組み合わせて使用​​ すると、解決策が得られる可能性があります。

于 2009-06-15T22:19:26.543 に答える
2

あなたのページを SVN にチェックインし、リリースの準備ができたら、ローカルの SVN 作業コピーから Web サーバーを更新します。wordpress、CSS、HTMLなど、すべてをSVNに入れます。

于 2009-06-13T17:17:02.853 に答える
1

私自身のプロジェクトでは、それが必要な場合は、ドキュメント用のサブディレクトリを作成し、すべてのファイルがそこの既知のベースから相対的に参照されるようにします。例えば、

index.html -- refers to images/example.jpg
README
-- subdirs....
    images/example.jpg
    section/index.html  -- links back to '../index.html', 
                        -- refers to ../images/example.jpg

ドキュメントが SVN/tarball ダウンロードに含まれている場合は、そのまま読むことができます。元のファイルから生成された場合、ダウンロード可能なバージョン用に事前に生成されます。

ドキュメントのアーカイブ バージョンを解凍/生成し、名前付きディレクトリ (docs/v1.05/ など) に配置できます。

たとえば、ローカル ディスクから /docs/ ディレクトリのサブディレクトリのリストを取得してリストを表示し、最新のものを強調表示するように記述できる単純な PHP スクリプトです。

于 2009-06-13T18:44:41.020 に答える
1

一部のプログラムでhelp & manual を使用しているのを見てきました。しかし、私はMacユーザーであり、それが良いかどうかを知る経験がありません. Mac用のソリューションを自分で探しています。

于 2009-06-13T17:17:55.427 に答える