👩🏻‍🤝‍👨🏾 🌎 💲 貧しいXWiki、一言で言えば-2 ♾ ♌️ 🤰🏻

記事の最初の部分では、標準インターフェースをより快適にする方法について説明しましたが、それ以来、 xWikiエンジンの両方の新しいバージョンがリリースされ、使いやすさを改善する方向にインターフェースが変わるほどの水が流れました。したがって、新しい記事では、ポータブルクライアント向けのxWikiのチューニングと微調整について説明することを提案します（JettyおよびHSQLDBバンドルに基づく）。すぐに予約しますが、これを最適な実装とは考えていませんが、ポータブルバージョン（適切なフォルダーにコピーして起動する）を展開する便利さを考えると、個人作業またはSpartan条件での小規模チームの作業には、これが最善の選択肢だと思います。

アンダーカットへようこそ

博覧会
最初に、いくつかのコメント：

1. xWikiを開始するには、ホストとして使用するPCにJavaをインストールする必要があります
2.構成について説明するポータブルバージョンは、WindowsとLinuxを実行するPCの両方で実行されますが、別々に説明するいくつかの点でチューニングが異なります。
3.著者の意見では、彼の経験に基づいて、Intel / AMDファミリーの別個のデュアルコアプロセッサと、少なくとも3〜4 GBのRAMまたは同様に構成された仮想マシンを別々のホストで快適に動作させることが望ましい。ホストがオフィス作業用のPC /ラップトップの場合、RAMを少なくとも4GBにアップグレードし、i3プロセッサー（またはそのアナログ）以上を搭載することをお勧めします。
4. Wikiエンジンの構成ファイルを正しく変更するには、Notepad ++または同様のものを使用します。
5.変更するたびに、念のためバージョンの中間バックアップを作成することをお勧めします。
6.プログラムは、技術エンジニア/見積もりとして作業結果を構造化するために、それ自身のために調整されました。

ネクタイ
執筆時点で、最新バージョンのXWikiを次のリンクからダウンロードします。
enterprise.xwiki.org/xwiki/bin/view/Main/Download

設置

インストールオプションのサポート：Windows、Debian、Webコンテナー（Webサーバー）-* .war、マルチシステムフォーマット* * .jarおよびJetty + HSQLDBバンドルに基づくwikiの移植可能なバージョン（IMHO、ユーザー設定/操作に最も便利） WindowsおよびLinuxで。

チューニングとチューニングを開始するには、ZIPアーカイブからディスクのルートにファイルを解凍する必要があります（フォルダーの名前を「D：\ xwiki」などの短いパスに変更することもお勧めします）。

ファイルとディレクトリ構造

。。
DIRデータ _____________データとDB
DIR桟橋 _____________Jetti
DIR META-INF _________ソフトウェアライセンスとコメント
DIR webapps __________ xWikiエンジン
start_xwiki.bat
start_xwiki.sh
start_xwiki_debug.bat
start_xwiki_debug.sh
stop_xwiki.bat
stop_xwiki.sh

起動は、Windowsのstart_xwiki.batファイル（ターミナル経由のLinuxのstart_xwiki.sh）によって実行されます。このファイルには、必要なすべての設定が既に登録されています。コンソールウィンドウは最小化することをお勧めします。次に、Webブラウザーウィンドウを開いて（コンソールウィンドウを閉じることは強くお勧めしません）、指定されたURLをコンソール（端末）から入力します。形式はhttp：// localhost ：8080 / xwiki / bin / view / Main /

今、あなたは働くことができます

デフォルトの管理者ユーザー名とパスワード：
ログイン：admin
パスワード：admin

開発

I.情報ストレージの構造。

データストレージの場合、Jettiに基づくポータブルバージョンは、HSQLDBデータベースとそのすべての長所と短所を使用します。特に、32 MBを超える投資にはソフトウェアの制限があります（必要に応じて増加できますが、このデータベースは使用できません）。おそらくあなたの特定のケースではこれで十分でしょうが、HSQLDBに小さなファイル（写真1..30Mb）を4GB以上詰め込むと、システムの動作が遅くなり、ある時点で新しい添付ファイルの受け入れを拒否します。テキストと添付ファイルを分離するには、次の方法も最適です。つまり、 xWikiはハードドライブ上のフォルダーにファイルを保存することをサポートします。

まず、添付ファイルの保存場所をデータベースからファイルシステムに変更します。このため、xwiki.cfg（.. \ webapps \ xwiki \ WEB-INF \）を変更する必要があります（構成ファイルの文字シーケンス＃-＃および＃はコメントを意味します）

xwiki.store.attachment.hint = file
xwiki.store.attachment.versioning.hint = file
xwiki.store.attachment.recyclebin.hint = file

ここの最初の変数は、添付ファイルがハードドライブに書き込まれることを意味します。 2番目は、添付ファイルのバージョンもハードドライブに保存されることを意味し、3番目は、削除されたファイルを含むバスケットもハードドライブに保存されることを意味します。このソリューションの欠点は、ファイルシステムに分類されるファイルへのパスの負荷です。

また、サイトのドキュメントには、このファイル構造に手を加える必要はないという発言があります。そうしないと、データとリンクが一致しなくなり、エラーが発生する可能性もあります。

有名なバグ

XWikiには、UIを介してごみ箱から添付ファイルを復元できないバグがあります。空のLiveTableが見つかります。添付ファイルの削除アクションにより、ドキュメントに新しいバージョンが追加されるため、添付ファイルを復元する正しい方法は、必要なバージョンにロールバックすることです。添付ファイル付きのドキュメントを削除してから、もう一度[削除]をクリックしてドキュメントを履歴から完全に消去すると、添付ファイルもシステムから一緒に削除されます
このバグが修正されるまで、ファイルシステム内の添付ファイルの混乱を避けるためのオプションの1つは、添付ファイルのごみ箱をオフにするだけです。

おおよその翻訳
XWikiには、ユーザーインターフェイスを介してごみ箱から削除された添付ファイルを復元できないエラーがあります。空のLiveTableが見つかります。 添付ファイルを削除するアクションは、ドキュメントのバージョンのカウンターをノックダウンするため、添付ファイルを復元する正しい方法は、目的のバージョンにロールバックすることです。アプリケーションでドキュメントを削除し、再度ボタンをクリックしてドキュメントを履歴から削除すると、添付ファイルも一緒にシステムから削除されます。このエラーが修正されるまで、ファイルシステム内の添付ファイルとの混同を避ける1つの方法は、削除されたすべての添付ファイルのゴミ箱を単に無効にすることです。

なぜなら削除されたファイルはユーザーインターフェイスのバスケットに表示されません（削除されたページには適用されません）。このバグが修正されるまで、削除されたファイルとそのバージョンのバスケットを無効にすることをお勧めします。

storage.attachment.recyclebin = 0
xwiki.store.attachment.versioning = 0

アクションを有効にするには、XWikiを再起動します

次に、投資のサイズの32MBの制限を変更しました。それはもはや関係ありません、これのためにそれは必要です：
1.移動： http：// "yourwiki" / xwiki / bin / edit / XWiki / XWikiPreferences？Editor = object
2.「XWikiPreferences 0」のリストを展開します
3.「最大アップロードサイズ」の項目までスクロールし、他の値（バイト単位で!!!）に変更します。
4. [保存]ボタンまでスクロールします

アクションを有効にするには、ページを強制的に更新します。

II。 インターフェイスのセットアップ

XWikiインターフェースの一般的なチューニングは前の記事で実行されたため、著者はこれについて詳しくは説明しませんが、新しい情報のコンパイルに焦点を当てます。

III。 Office統合を構成する

もちろん、 Open Office / Libre Officeを意味します。最初に、システムにパッケージの1つをインストールする必要があります。次に、xwiki.properties（.. \ webapps \ xwiki \ WEB-INF \）を変更し、パラメーターを設定する必要があります。

openoffice.autoStart = true

また、インストールされているオフィススイートのディレクトリへのパスを次の変数で指定します。

openoffice.homePath = C：/ユーザー/ {user} /AppData/Roaming/openOffice.org/3
openoffice.profilePath = C：/ Program Files / OpenOffice.org 3

既知のバグと回避策

XWikiバグ7164バグのため、XWikiはxwiki.propertiesファイル内のオフィスサーバーのopenoffice.homePath変数を無視します。これを行うには、WindowsのXWikiディレクトリにあるstart_xwiki.batファイルに、次の行を追加して変更する必要があります（インストールされているOfficeパッケージへのパスを考慮して）。

set XWIKI_OPTS =％XWIKI_OPTS％-Doffice.home = "C：\ Program Files \ LibreOffice 3.4"

Linuxの場合、start_xwiki.shファイルを変更します

XWIKI_OPTS =％XWIKI_OPTS％-Doffice.path = / usr / lib / libreoffice /を設定します

XWikiを再起動します。

約英語でのインストールの詳細な説明へのリンク。

IV。 快適な作業と管理のための拡張機能

拡張機能の一般的なリストは、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Main
すべての拡張機能のインストールは、管理パネルから実行されます。拡張機能をインストールする2つの方法があります。
1.「Wikiの管理」->「拡張機能マネージャー」->「拡張機能の追加」に移動します。次に、検索文字列に名前またはラテン語の名前/機能の一部を入力し、表示された結果で「Enter」を押します。拡張機能のベースおよび拡張機能自体はXWiki Webサイトにあり、「インストール」、「続行」
2.サイトから* .xar拡張子のファイルをダウンロードし、「Wikiの管理」->「コンテンツ」->「インポート」に移動し、ファイルを選択してダウンロードし、ウィンドウでクリックしてインポートに同意します。

管理：添付ファイルのエクスポート-すべての添付ファイルのエクスポート

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Export+All+Attachments

リンクで利用可能なコード

=Export Attachments=

{{info}}
By default, the export is made from the **current database** and from **all spaces**.
{{/info}}

{{velocity}}
{{html}}
; Database:
: />
; Space name:
: />
; Path to directory to write to:
: />
; /> Confirm
: />

{{/html}}
{{/velocity}}

{{groovy}}
import com.xpn.xwiki.*;
import com.xpn.xwiki.api.*;
import com.xpn.xwiki.doc.*;

import org.apache.commons.io.FileUtils;

import java.io.File;
import java.net.URL;

class ExportedAttachments {
static attachmentsNo = 0;
}

// Export attachments
def void exportAttachments(XWikiContext context) {
def dirPath = request.dirpath + "/";
def dir = new File(dirPath);

String hqlDocCount = "select distinct count(doc.name) from XWikiDocument as doc";
String hqlDocList = "select doc.fullName from XWikiDocument as doc";

if(request.spaceName && request.spaceName != ''){
hqlDocCount += " where doc.web='" + request.spaceName + "'";
hqlDocList += " where doc.web='" + request.spaceName + "'";
}

XWiki wiki = context.getWiki();

int total = wiki.getStore().search(hqlDocCount, 0, 0, context).get(0);
println "**" + total + "** documents to search for attachments";

List documentNames = null;
int offset = 0;
while (documentNames == null || documentNames.size() == 100) {
documentNames = wiki.getStore().search(hqlDocList, 100, offset, context);

for (docName in documentNames) {
try {
XWikiDocument doc = context.getWiki().getDocument(docName, context);
exportDocAttachments(doc, dir, context);
} catch (Exception e) {
println "{{error}} Error : " + e + "{{/error}}";
}
}

offset += documentNames.size();
}

println "";
println "((({{info}}Export done.{{/info}})))";
println "**" + ExportedAttachments.attachmentsNo + "** attachments exported.";
}

// Export attachments for the given document
def void exportDocAttachments(XWikiDocument doc, File dir, XWikiContext context) {
if(doc.getAttachmentList().size() > 0){
println "* **" + doc.fullName + "**";

for (XWikiAttachment attach in doc.getAttachmentList()) {
println "** " + attach.filename;

try {
// Create file
File spaceDir = new File(dir, java.net.URLEncoder.encode(doc.web));
File docDir = new File(spaceDir, java.net.URLEncoder.encode(doc.name));
File destinationFile = new File(docDir, java.net.URLEncoder.encode(attach.filename));
def attachmentURL = doc.getExternalAttachmentURL(attach.filename, 'download', context);

// Copy attachment from URL
URL url = new URL(attachmentURL);
FileUtils.copyURLToFile(url, destinationFile);

ExportedAttachments.attachmentsNo++;

}catch(Exception e){
println "{{error}} Error: Could not create file: " + e + "{{/error}}";
}
}
}
}

// Handle request
if(request.confirm && request.dirpath){
// Set database
def currentDatabase = xcontext.getDatabase();
def newDatabase = currentDatabase;
if(request.dbName && request.dbName != ''){
newDatabase = request.dbName
}
xcontext.setDatabase(newDatabase);

println "=Exporting attachments from **" + newDatabase + "** wiki=";

// Export
exportAttachments(xcontext.context);

// Reset database
xcontext.setDatabase(currentDatabase);
}
{{/groovy}}

特定の各Wiki / SubWikiのすべての添付ファイルを大量に保存すると便利です。これを行うには、任意の名前の別のページが作成され、コードがコピーされ、ページが保存され、フォームフィールドが結果のオブジェクトに手動で入力されます。

解決策の短所-XWikiはUTF-8エンコードで動作するため、キリル文字のファイル名は文字と数字のセットを変換するため、入力は手動で行われます。これは不便です。これを解決するには？現在、著者は創造的な検索を行っています。

添付ギャラリー-ライトボックスマクロ

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Lightbox+Macro
インストールと構成については、前の記事で説明しました。

タスクマネージャー-タスクマネージャーアプリケーション

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Task+Manager+Application

最もタスクマネージャー。プラスは無料で比較的柔軟であり、マイナスは添付ファイルのパスの長さ制限に反するため、Windowsで実行する場合は、添付ファイル名とタスク名およびプロジェクト名を短くすることをお勧めします。また、引用符を避けることをお勧めします編集時に、エディターはタスク名を最初の「引用」の後のフレーズの最後まで切り詰めようとします。

列の外部表示は変更できます。著者の意見では、個人的な使用には不必要な情報が多少ありますが、重要な点は標準表示の「％完了」です。したがって、タスクマネージャーページに移動し、WYSIWYGではなく通常のエディターで編集ページを選択し、次のテキストをコピーします。

コード

{{velocity}}
#set ($discard = $services.localization.use('document', 'TaskManager.TaskManagerTranslations'))
#set ($discard = $xwiki.ssfx.use('uicomponents/widgets/userpicker/userPicker.css'))
#set ($columnsProperties = {
'number': {"type":"number","size":10},
'name': {"type":"text","size":10, "link":"view"},
'project': {"type":"list","size":10},
'status': {"type":"list","size":10,"html":true},
'severity': {"type":"list","size":10,"html":true},
'reporter': {"type":"text","size":10,"html":true},
'assignee': {"type":"text","size":10,"html":true},
'duedate': {"type":"text","size":10},
'progress': {"type":"number","size":10, "html":true},
'_actions': {"sortable":false,"filterable":false,"html":true,"actions":["edit","delete"]}
})
#set ($options = {
'className': 'TaskManager.TaskManagerClass',
'resultPage': 'TaskManager.TaskManagerLiveTableResults',
'translationPrefix': 'taskmanager.livetable.',
'tagCloud': true,
'rowCount': 1000,
'maxPages': 100,
'selectedColumn': 'number',
'defaultOrder': 'asc'
})
#set ($columns = ['number', 'name', 'project', 'progress', 'status', 'severity', 'reporter', 'assignee', 'duedate', '_actions'])
#livetable('taskmanager' $columns $columnsProperties $options)
{{/velocity}}

「progress」フィールドがここに追加されます： 「progress」：{"type"： "number"、 "size"：10、 "html"：true}、つまり、行の進行#set（$ columns = ['number'、 'name'、 'project'、 'progress'、 'status'、 'severity'、 'reporter'、 'assignee'、 'duedate'、 '_actions'] ）このパラメーターはプロジェクトの後に追加されます。ご意見のとおり、一部の列が冗長である場合は、行を編集して表示をここで削除できます。

このタスクマネージャーが知らないことは、期限切れのタスクについて通知し、通常はシグナルを送ることです。おそらく著者はこれを次のバージョンに追加するか、機能が改善された新しいタスクマネージャーがリリースされるでしょう。ただし、情報の構造化とWikiプラットフォームでの一般的な作業については、それは良いことです。マイナスの点として、タスクを作成および編集するときにWYSIWYGエディターがないことに注意する価値がありますが、これらのページはマクロとプログラミングコードを正しく実行します。

ファイルマネージャー-ファイルマネージャーアプリケーション

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/File+Manager+Application
必要なファイルを手元に保存するオプションは、プライベート/パブリックミニクラウドです。すべての添付ファイルをエクスポートとは異なり、PCにファイルをアップロードするときにキリル文字を正しく処理します。

チャートウィザード-ダイアグラムアプリケーション

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Diagram+Application

会議スケジューラ-会議アプリケーション

他の写真

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Meeting+Application
ミーティングプランナーには組み込みのグラフィカルカレンダーインターフェイスがあり、GoogleMapsからの画像もミーティング場所に添付されます。

カレンダー-Moccaカレンダーアプリケーション

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/MoccaCalendar
カレンダーは日記です。

インターフェイス要素-XWikiトップに戻る

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Back+To+Top
複数のページを占めるテキストをスクロールすると、ウィンドウの右下隅に「上へ」ボタンが表示されます

インターフェイス要素-タブマクロ

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Tabs+Macro
編集したページにタブを追加できるマクロ

たとえばコード

{{tabs idsToLabels='tabId11=My xwiki-wide tabs, tabId12=My working tabs :)' /}}
(%id="tabId11"%)((({{box cssClass="tabId11div"}}
First tab!
{{/box}}
I can post any content here
)))

(%id="tabId12"%)((({{box cssClass="tabId12div"}}
Second tab!
{{/box}}
And here too
)))

インターフェイス要素-ShowHideマクロ

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Ajax+and+Show+Hide+Macro
テキスト用のカスタマイズ可能なスポイラー。

注釈（統合マクロ）

英語の説明は、次のリンクから入手できます。
extensions.xwiki.org/xwiki/bin/view/Extension/Annotations+Application
千の言葉の代わりに...

クライマックス
XWikiは、Java、 LGPL配布ライセンスで書かれた第2世代のWikiであり、機能にはブログ、APIツール、コメント、LDAP認証、PDFへのエクスポートページが含まれます。世界中の多くの企業で使用されています。ロシア語を含む25のインターフェース言語。

2番目の記事の目的は、出張などのフィールド条件で作業するための設定を説明することです。 VETエンジニアには何が必要ですか？ 15インチディスプレイ、オフィスソフトウェアパッケージ、情報を格納および構造化するシステム、少なくとも1日2〜3時間、メールを送受信するためのインターネットアクセスポイントを備えたラップトップ。Wikiを使用する理由、つまり、バージョン管理が必要です。これは、OSのハードな手段で簡単に整理できますが、同時に、バージョンに関するコメントはファイルよりも価値がある場合があり、すべてのアプリケーションが正常に解決するイベントとマイクロイベントの特定の日記を保持できるアプリケーションも必要です追跡（カレンダー）およびタスク（タスク）。

仕事の結果：
これで、機能を含むWikiエンジンができました。
-ブログ;
-WYSIWIGエディター。
-画像ギャラリー。
-新しいマクロの編集および作成の可能性。
-プログラミングスクリプト（Velocity、Groovy、Python、Ruby、PHP）の可能性と、人気のWikiエンジン（Confluence、JSPWiki、Creole、MediaWiki、TWik）の構文サポート。
-カレンダーと会議プランナー。
-タスクマネージャー;
-チャート作成;
-Officeアプリケーションとの統合。
-ファイルマネージャー。

ご清聴ありがとうございました。 :)

貧しいXWiki、一言で言えば-2

More articles: