ただし、15.04以前のMaharaテーマは、Mahara 15.10と互換性がない可能性があります。これは、フロントエンドコード(CSS、Javascript、HTML
)にBootstrapフレームワークを使用するようになったためです。その結果、ほぼすべてのテンプレートファイルとCSSファイルが大幅に書き直されました。
また、Mahara gitリポジトリには、CSSにコンパイルする必要があるSASSファイルが格納されるようになりました。静的CSSファイル自体を保存するのではなく。
htdocs/theme/
ディレクトリにある"Readme.md
"ファイル:https://github.com/MaharaProject/mahara/blob/master/htdocs/theme/Readme.md
subthemestarter
"サンプルテーマ:styleguide.php
"ファイル。これを表示するには、Maharaに管理者としてログインし、Maharaサイトの/theme/styleguide.php
にアクセスします。
前述のように、Maharaのgitリポジトリには、コンパイル済みのCSSファイルが含まれていません。代わりに、CSSにコンパイルする言語で記述されたSASSファイルが含まれ、変数やコードの再利用など、プログラマーのさまざまなトリックを可能にします。 これは、CSSが「ビルド製品」になり、バージョン管理システム(Gitなど)からビルド製品を除外することがベストプラクティスであることを意味します。
したがって、Mahara 15.10テーマで作業するには、SASSファイルが必要であり、それらをCSSにコンパイルできる必要があります。
gitからMaharaをチェックアウトすると、SASS(具体的には.scss
)ファイルはあるが、CSSファイルはないことがわかります。 そのSASSをコンパイルする必要があるだけです。"theme/Readme.md
"ファイルには、これを実現する方法が記載されています。
LaunchpadからMaharaをダウンロードした場合、読み取り不可能な縮小されたCSSファイルがたくさんあり、このSASSの誰もが話していることに気づかないでしょう。これは、Launchpad上のZIPファイルがパッケージ化されたリリースであるため、SCSSファイルやテストスクリプトなど、開発中にだけ必要なファイルが削除されるためです。gitからMaharaのクローンを作成するか、gitレポジトリのパッケージ化されていないzipを次からダウンロードする必要があります:
https://git.mahara.org/mahara/mahara/tags
gulp
' を実行すると、このパッチの前と同じように動作します。
gulp --production false
'を実行すると、CSSがデバッグコメント付きでコンパイルされます。
make css
'を実行すると、以前と同じように動作します。
make css production = false
'を実行すると、CSSがデバッグコメント付きでコンパイルされます。
template
"、その他すべて(CSS、画像など)を格納する"static
"、およびプラグイン(アーティファクト、ブロックタイプなど)の外観をカスタマイズする「各プラグインタイプのディレクトリ」というディレクトリがありました。新しいテーマの開発者は、これは混乱していると私たちに言いました。特に、静的ではないがコンパイルされたSASSファイルを"static
"ディレクトリに追加したときはなおさらです。 そう:
plugintype
"というディレクトリに移動しました
htdocs/theme/raw/blocktype/creativecommons/...
htdocs/theme/raw/plugintype/blocktype/creativecommons/...
static
"ディレクトリにあったすべてのテーマファイルを、テーマのルートレベルに移動しました。
htdocs/theme/raw/static/images/logo.png
でした。
/htdocs/theme/raw/images/logo.png
theme/Readme.md
をお読みください。ブートストラップのチュートリアルを読んでください。コンピュータでgulp
とnpm
を実行する(Windowsでも実行できます)か、他のシステムでSASSをコンパイルします(これはオープンスタンダードです。パッチを歓迎します!)。古いアドホックシステムよりもブートストラップ方式を好む場合があります。
これは、Maharaコアチームが下位互換性を提供するために実装を検討した考えですが、古いシステムに継続的なサポートを提供するよりも、新しいテーマを改善するためにリソースを使用する方が効果的であると判断しました。ただし、Mahara 15.10では技術的に可能であるはずです。
15.10の15.04テーマの大きなブレーカーは、15.10の"raw
"テーマに15.04からの大きな変更が含まれており、すべてのテーマが最終的に15.04以前のraw
から継承されていることです。
ただし、15.10では、テーマが親を持たないことを宣言できるようにしたので、"alternate raw
"になります。したがって、"raw
"のテーマを15.04から15.10に移植し("legacy
"と呼びます)、15.04テーマを"raw
"はなく"legacy
"から継承するように変更することもできます。
15.10セレクターを必要とするJavascriptの一部と、Maharaのインタフェースの一部(特にページのアクセス許可画面)が大幅に書き換えられたため、おそらくまだいくつかの変更が必要です。
ただし、絶対にbootstrap
を嫌い、15.04テーマ設定システムを強く好む場合、これはオプションです。
これを実装する場合は、Maharaフォーラムのコミュニティと共有してください。15.04のテーマを愛する人々からヒーローとして称賛されます。