NPJは、プロジェクトとドキュメントを管理するための効果的なツールです

仕事用ネットワークでドキュメントを維持することは、自分自身をプロのシステム管理者として尊重し、考える人にとっては長年の良い習慣です。 ここでのポイントは、公式の義務ではなく、むしろ直接必要なことです。





特に、ネットワークが複数のサーバーと5つのワークステーションで構成されている場合。 Linuxサーバーの場合、このルールは実際には2つあります。同じサービスを構成する方法は2つも3つもあり得ないからです。



多くの場合、オープンソースプロジェクトでの作業（プロジェクトの開発やインストールは関係ありません）は、ドキュメントの読み取りと作成に密接に関連しています。 個人の記憶は選択的であり、「現在使用されていない知識」を「遠い棚」から削除する能力があることは誰もが知っています。 このような知識の量は、経験と会社のサーバーパークのサイズに直接依存します。



私自身の経験から言えば、「標準」ソリューションをセットアップするための有能に書かれた（自分の手で）数十の文書は、人生を大幅に簡素化し、痛みを伴う記憶を永久に軽減します。 今回、どこで処方するのを忘れたのか、かつて出会ったどのようなニュアンスが私の記憶の奥底から浮かび上がってくるのかについては、もう考えられません。 おそらく、すべてを常に覚えているスーパープロフェッショナルがいることは否定しませんが、彼らは私には知られていないでしょう。 グル、私はノー、ノー、そして彼らは、「何かが...私は正確に覚えていない」という質問に答えて言った。



なぜ私はこれをすべてしているのですか？ そして、あなたが問題に遭遇したサービスのセットアップ、出会った微妙さや特異性についてのドキュメントを（少なくともあなた自身のために）書く習慣は、安全に非常に有用な習慣であり、非常に必要な実践と呼ぶことができます。 これは多くの人々の習慣の論理的な継続です。情報を見つけるのにあまり便利ではないPDA、ドキュメント、その他のソースに書き込むことです。



NPJとは何ですか。

最も便利なツールからドキュメントを作成するには、「NetProjectJournal」または単にNPJを選択できます。 それは、オープンソースプロジェクトの仕事の原則に基づいて構築されています。 人々はコミュニティ（ワーキンググループ）に集まり、何らかのドキュメントを作成します。 プロジェクト管理の例として、非常に簡単ですが、「ケーキ」（http://npj.ru/cake）の請求はそれほど便利ではありません。 この場合、NPJは柔軟なツールであり、実際にあらゆる能力で行動できるため、プロジェクトサイトがメインページであり、ドキュメントを開発する場所であり、プロジェクトをサポートする場所です。 ドキュメントの開発と収集を主な目的とするリソースの例については、npj.akeeper.ruを引用できます。NPJノードの非常に高度な検索ツールを考えると、これは非常に便利なツールです。



アメニティの本質：

•通常、インストールと構成には5〜10分かかります。

•アーキテクチャの柔軟性により、サイト上でほとんどすべてのものを作成できます-些細なブログ（NPJを使用して個人のライブジャーナルを維持するリソースがあります）から、プロジェクトの開発、プレゼンテーション、管理のための本格的なリソースまで。

•他のシステムのノードでの承認（詳細は後述）により、NPJノードの共通ネットワークに接続されている任意のノードで作業に参加できます。

•任意のノードで、任意の数のワーキンググループを作成できます。各ワーキンググループは、独自の独立したプロジェクトに参加できます。

•ワーキンググループは、パブリック、事前モデレート、非表示にできます。

•サイト内の任意のページは、通常のドキュメントからフォーラムフォーム（詳細は後述）に至るまで、あらゆる容量で動作できます。

•ワーキンググループへの参加に加えて、サイトユーザーは常に自分の個人ジャーナルと自分のドキュメントを作成する能力を持っています。

•権利システムを柔軟に構成できるため、誰が、何を、どのユーザーがアクセスできるかを決定できます。 （これは、ワーキンググループのドキュメントとレコードの両方、および任意のユーザーのレコードを含むドキュメントに適用されます。レコードまたはドキュメントを作成するアクセス権はユーザーのみが決定します。）

•インデックスを提示し、ワーキンググループのすべてのドキュメントを分類するいくつかの方法。

•サイト全体の簡単な検索。

•サイトでは、適切なアクセス設定に従って、すべてにコメントすることができますが、コメントを受信して​​メールクライアントから直接応答することができます。 （ばかげた手紙はもうありません。「あなたが購読している新しいコメントが表示されます。リンクをクリックして表示してください。」-忘れてください！生活がずっと簡単で便利になりました。）

•ドキュメントの開発中、その変更の履歴が保持されます。これはいつでも表示でき、どのような変更や追加が行われたかを正確に知ることができます。 さらに、ドキュメントの保存されたバージョンのいずれかにいつでも戻ることができます。

•ドキュメントはワーキンググループによって発表され、その存在について通知されます。 ダイジェストを作成することは可能です。

•Wikiマークアップのおかげで、ドキュメントの作成は簡単ではありませんが、非常に簡単です。 とてもいいです

•各グループ、ユーザーのインターフェース-個別に設定されます。

•中央のページから直接表示する機能：すべてのドキュメント、すべてのユーザーのドキュメントの変更、すべてのユーザーのフィード、すべてのアナウンスのフィード、ダイジェストの変更のリストなど。

•RSSサポート。

•バグトラッカーがあります。



上記で、異なるノードでのパススルー認証について説明しました。 実際、「NetProjectJournal」の各ノードには、統一された共通ネットワークに入る能力があります。 これは、設定でリンクのペアをクリックすることにより行われます。 このシステムの操作メカニズムは非常に単純です。ゲストNPJを入力すると、システムは（あなたの）ホストからCookieを見つけ、そこから許可を求めます。 ホストが承認を確認すると、ゲストホストではyournick @ yourhostという名前で表示され、すべてのアクティビティは匿名でなくなります。 なぜこれが重要なのですか？



この方法で許可されたアクティビティのおかげで、さまざまなサイトからの通知をサブスクライブできます。 これは、NPJの最も便利な機能の1つです。 以下に関する通知を受け取ることができます。

•新しいドキュメントの作成。 含む、すべてのマークアップを含む、まったく新しい文書をレターで受け取ります。

•既存のドキュメントの変更。

•サイトでの発表（新しいグループ、コミュニティ、開発の作成に関する）。

•投稿に対する新しいコメント。お気に入りのメールプログラムから直接これらのコメントに返信することを含みます。

•その他の通知。



特に注目すべきは、雑誌のどのページもまったく異なる品質で表示できることです。 明確にするために、このシステムのアーキテクチャについて少し話す必要があります。 「NetProjectJournal」のアーキテクチャの本質は、「ここに粘土があり、それが頭に浮かび、彫刻された」と表現できます。 これは、各ページが編集可能であり、それ自体に情報を含めることができ、（たとえば）セクションの目次になることができることを意味します。 存在しないオブジェクトへのリンクをページの本文に作成できます。 作成したページを保存した直後に、このリンクに移動して、すぐにそのページに配置されるドキュメントを作成できます。 そして、それがドキュメントなのか、別の目次、カタログ、インデックス、ゲストブックなどなのかを決めるのはあなただけです。



すぐに目を引く潜在的な「マイナス」は、Webインターフェースを介してサーバーにファイルをアップロードできないことです。 言い換えると、ドキュメント内または他の場所にあるファイルへのリンクを配置する場合は、他のサービスのヘルプを使用してこのファイルをサーバーに配置する必要があります。



私が注目したい別の詳細。 NPJはOOPの概念を使用して記述されているため、機能の追加は難しくありません。 たとえば、NPJシステムに必要な変更が加えられ、このシステムとphpbb2フォーラムの両方で1つの共通ユーザーベースを使用できるようになりました。 非常に便利であることが判明し、実装には2日もかかりませんでした。



NPJの外観と動作。

NPJノードのインストールに特別な努力は必要ありません。 彼らが言うように、すべてがスムーズに進み、システムは箱から出ます。 プロジェクトのWebサイト（http://www.npj.ru）には詳細なインストール情報が含まれており、システムの最新バージョンをいつでもダウンロードできます。 開始するには、 npj.ru / npjdev / releaseページをご覧ください。 NPJが動作するには、Apache（他のWebサーバーでも動作する可能性があります）、MySQL、PHPが必要です。 プロジェクトのWebサイトには、インストールに必要な最小限のコンピューター構成に関する情報はありません。 ただし、次の構成（p3、256 mb ram、10ギガバイトhdd）のLinuxマシンにnpjをインストールしましたが、作業中の問題に気付きませんでした。



新しいノードを構成するプロセスについては説明しません。既に述べたとおりです。包括的な情報は開発者のWebサイトにあります。 （これは同じNPJノードです）注目するのは、2つの設定だけです。 メールで通知を受信する場合は、NPJのメールアカウントを作成し、pop3アクセスを提供する必要があります。 この設定はconfig_tunes.phpファイルに記述されています。 また、上記で説明した快適な些細なことで他のノードでの作業に参加したい場合は、共通ネットワークでのノードの統合をオンにします。 これは、管理ページ（ npj.example.ru/manage/nns）を 2回クリックすることで実行されます。



インストール後、デフォルトでnode @ hostnameと呼ばれる1つのグループと、すべてのユーザーがアクセスできる個人領域を自由に使用できます。





図1.個人空間の外観の例。



独自のプリセットを作成していないユーザーのデフォルトと同様に、サイトのデザインオプションをいくつか選択できます。 最初はプロファイルの設定で、2番目はノードの設定でそれぞれ行われます。 デフォルトでは、「simplifica」スタイルが設定されていますが、多くは禁欲的な「アカデミック」スタイルを好みます。 確かに、どちらの機能も私には適していないので、どちらも好きではありません。 写真にある「みにくい」を使っています。 その主な利点は、ページの多くの機能やプロパティにすばやくアクセスできる便利さです。 たとえば、残念ながら、「アカデミック」スタイルの検索への迅速かつ便利な（そして最も重要なのは（閲覧中のページに関係なく）永続的な）アクセスを実現する方法を理解していませんでした。



ユーザー設定を確認する他の理由があります。 たとえば、wiki / wakマークアップを使用するか、MS Wordスタイルのより視覚的なエディターを使用するかを選択できます。



あなたの個人的な領域で、あなたは（同じライブジャーナルのように）あなたの日記を保存することができ、そして例えば、この方法で、あなた自身のためにサイトで開発を記録します。 そこでは、どのワーキンググループにも結び付けられていない独自のドキュメントを作成する機会があります。 厳密に言えば、多くの人々が関与するプロジェクトを提供する目的でサイトが作成されていない場合、ワークグループは必須の属性ではありません。 私は、NPJが独自のローカルマシンにインストールされ、個人的な目的でのみ使用されたケースをかなり知っています。



このすべての富を見るとすぐに、このすべてをどのように使用するかという疑問が生じます。 残念ながら、幸いなことに、NPJの「エントリレベル」はかなり高いため、最初はユーザーがノードと対話する方法について多くの質問がありました。 ここで、表現は救助に来ます。それはすでに上で発音しました-サイトの各ページは「塑像用粘土」であり、そこから何かを「彫刻」できます。 私が話していることを理解するには、サイトの任意のページをダブルクリックするだけです。 たとえば、中央の1つ。 管理者権限がある場合-ページを編集するためのウィンドウを取得します。





図2.ここから作成を開始できます。



この時点から、あなたのサイトのメインページを認識を超えて可能な限り変更することができます。 さまざまなタグとマークアップの説明へのリンク-www.npj.ru/node/chastyevoprosy/zapisizhurnala/wikisintaksisを使用します。 メインページのデザインには、書かれていない標準があります。 ただし、それらに従う必要はありません。 別のサイトに移動するだけで、タイトルページがどのように見えるかを確認できます。





図3.サイトのメインページの典型的なデザイン。



中央ページが終了したら、ワーキンググループを開始するかどうかに応じて、ワーキンググループの編集に進むか、個人用スペースで作業を開始できます。 詳細については、ワークグループが単一のユーザーに対してステルスで存在する場合があります。 これは、サイトが公開されており、多くの人がサイトにいて、何らかの理由で作業している情報を漏らしたくない場合に非常に便利です。 （私はこれを使用して、インターネット上でアクセス可能なサイトで会社のネットワーク全体のドキュメントを管理しました。）



NPJノードのワークグループは、実際にはノードのユーザー間の権利の区別です。 グループのメンバーが使用する情報を発行（表示）するためのポリシーを決定し、各メンバーのアクセス権を決定するために存在します。 グループは、公開され、事前にモデレートされ、また前述のように非表示にできます。





図4.グループをより慎重に検討します。



グループメンバーは、閲覧から管理者（管理者）まで、さまざまな権利を持つことができます。 もちろん、彼らのグループ内。 ユーザーがマネージャーである場合、メインワークグループがnode @ hostnameであっても、これは彼がホストの管理者になることを意味しません。



ワーキンググループを作成した場合（または既存のワーキンググループを使用することにした場合）、すぐに設計に進み、マテリアルを入力できます。 これを行うには、グループページに移動します。これは、原則として、 ホスト名/ワークグループ名のように見え、中央ページのようにダブルクリックします。 使い慣れた編集ウィンドウが開きます。



ワーキンググループの最初のページのデザインは、材料のルブリケーター、アルファベット順のリストなどで構成されます。 また、（たとえば）ルブリケーターを使用するには、コードをページに追加するだけで、ルーブリックが自動的に表示されます。 （もちろん、ドキュメントを入力するときに、ドキュメントの見出しを指定する必要性を考慮します。）



上記の機能を試すために、新しいワーキンググループのページにある2つのオブジェクトへのリンクを作成しましょう。 最初のリンクがドキュメントで、2番目のリンクが目次であることを意味するとします。





図5.「プラスチシン」をくしゃくしゃにし始めます。



保存後、リンクに点線と最後に疑問符が付いた下線が表示されます。 この疑問符をクリックすると、まだ存在しないオブジェクトを作成するよう求められます。



最初のページにテキストを入力し、2番目のページに目次を作成します。





図6.同一ページの2つの化身。



ご覧のとおり、ページが異なる目的のために意図されていたという事実から、その本質は変わっていません。 新しいセクションの目次を最初のドキュメントに追加できます。 それどころか、作成した2番目のページにテキストを記述して、（たとえば）写真を配置できます。



いつでも、ほぼすべてのページのコードを表示できます（さらに、サイトだけでなくてもかまいません）。 これを行うには、 npj.example.ru / page / sourceと入力するだけで、wikiマークアップに指定されたページが表示されます。



NPJノードの各ページが、必要なものすべてを含むことができるテンプレートであることを理解したことを願っています。 実際、これはあなた自身が必要だと思った方法で相互接続されたたくさんのhtmlファイルと考えることができます。 通常のhtmlテキストの山から、それらは、使いやすさ、編集のしやすさ、および上記で既に表明されている他の「ユーティリティ」によってのみ区別されます。



職場でのNPJの使用。

NPJに保存する特定のドキュメントは、あなた次第です。 私自身からこのスキームを共有することができます。そのおかげで、それがどこにあり、どのように機能するかについての質問に（当局または私自身に）答える問題が永遠に消えてしまいました。 このスキームは、City-Info社で使用されました。





図7.「City-Info」ワーキンググループの構造。



この図からわかるように、実際には、会社のシステム管理者のサービスのすべての作業領域がここで強調表示されています。 もちろん、一部の情報は図に表示されず、「その他」の項目に含まれますが、理解するには十分すぎるほど表示されます。 矢印はセクション間のリンクを示します。 実際、多くの相互参照もドキュメント内にありますが、これをダイアグラムに表示することはできません。



同じ場所で、ドキュメントの開発を行いました。その後、ドキュメントは顧客と顧客に提供されました。 NPJは、このような作業を一緒に実行するだけでなく、ドキュメントの変更を追跡することも許可しました。 また、特定の変更の導入について議論するためのスペースを提供しました。 後に、そのような作業（地理的に離れたユーザーを含む開発）を実行するのに最も適していると認められたのはこのツールであったため、ドキュメントのパッケージ全体の開発がそこで開始されるはずでしたが、それまでに会社を辞めていました。



NPJでコンパイルされたドキュメントが私たちの仕事にどのように役立ったかについてはお話ししません。「推測」とは何かを忘れたり、何かを疑ったりするだけで十分です。目の前でブラウザとすべての詳細情報を開いてください。



結論

考えられる限り、作業でNPJノードを使用する方法はいくつもあります。自分のジャーナルに「未来のために」興味深い発見を書き、特に成功した設定ファイルやその説明をドキュメントに保存したいかもしれません。ネットワーク上のすべてのドキュメントを保持する別のワーキンググループを作成することもできます。または、現在開発中のプロジェクト、または現在計画中のプロジェクトのサポートでサイトを輝かせることもできます。



NPJの作業の複雑さの多くは、この記事の範囲を超えています。これにはいくつかの理由があります。第一に、私は長い間このシステムを使用してきたという事実にもかかわらず-私にとってすべての微妙さが開示されているわけではありません。第二に、記事の範囲外に残された記事の多くはめったに使用されず、誰もが興味を持つわけではありません。たとえば、ドキュメントを作成できない「コミュニティ」の使用。これは議論の余地のある形式ですが、私はそのためのアプリケーションを見つけられなかったので、私の話でそれを見逃しました。そして、NPJを使用する上で最も困難な問題、それがどのように機能するかを理解し、私があなたがそれを解決するのを手伝ってくれることを願っています。



あなたが仕事でそのような便利なツールを使用することに慣れた後、私は確かにあなたに一つを伝えることができます、それは不可欠なアシスタントになります。そして、これは驚くことではありません。あなたは思考や文書全体を保存する場所を探すのに時間を費やさず、美しい構造を構築することに苦しむことも、必要な検索結果を提供したくない誤った検索に苦しむこともありません-あなたは自分の仕事をするだけです。



キーパーのアレクセイ・コルシュノフ。System Administrator誌に

最初に掲載されました。