README / シェルガイド

README / シェルガイド

読む・移動する
  pwd                            現在のディレクトリを表示
  ls -la                         隠し項目と権限も表示
  cat /site/pages/about.txt       ページを出力
  nano /site/pages/about.txt      ページを編集
  cd /site/galleries/sunset       ギャラリーへ移動
  ./show.sh                       マニフェストを表示

nano では Ctrl+O、Enter で保存、Ctrl+X で終了、Ctrl+W で検索します。タッチ用の
ボタンも同じキーを送ります。Ctrl+Shift+M で端末から設定に移り、Escape で戻ります。
端末を拡大すると、編集するスペースが増えます。

画面との橋渡し
  ocean help
  ocean models
  ocean model torus
  ocean model house
  ocean model camera
  ocean speed 0.25
  ocean gallery /site/galleries/sunset/manifest.json
  ocean gallery /site/galleries/photographs/manifest.json
  ocean close

「人と場所」は、撮影者名を添えた Unsplash の十五枚の写真です。サイト所有者が
撮影した作品ではありません。マニフェストでは、五枚のポートレートに続いて、
十の場所の習作を並べています。

新しいセッションでは、形をランダムに選んで始まります。自動切り替えが有効なら、
/home では家、ギャラリーフォルダーではカメラが選ばれます。形を自分で選ぶと、
新しいセッションを始めるか、「表示」で自動切り替えを再び有効にするまで、
自動の変更が止まります。

自分のセッション用ギャラリー
sudo su の後、コレクションをコピーしてマニフェストを編集します。
  cp -R /site/galleries/sunset /site/galleries/mine
  nano /site/galleries/mine/manifest.json
  bash /site/galleries/mine/show.sh

スクリプトは自分のあるフォルダーを見つけるので、コピー先のマニフェストを開きます。
タイトルやキャプションを変えたり、画像を削除したり、ほかのギャラリーから SVG を
コピーして src に追加したりできます。JSON の引用符とコンマを保ってください。
画像のパスはマニフェストのフォルダーからの相対パスです。再実行すると最新の
ファイルが読まれます。編集後は「ASCII に戻る」か ocean close で閉じて開き直します。

マニフェストのない新しいフォルダーなら、ヘルパーに一覧を作らせます。
  mkdir -p /site/galleries/collected
  cp /site/galleries/signal/pulse.svg /site/galleries/collected/
  ocean gallery /site/galleries/collected

フォルダー指定では対応画像をファイル名順に並べます。追加・削除後にもう一度実行すると
自動生成マニフェストを更新します。明示的なマニフェスト指定は、手で決めた順を保ちます。

マニフェストの例
  {"title":"My study","images":[
    {"src":"sunset.svg","alt":"Layered waves below a warm sun",
     "caption":"A horizon from the Afterglow collection."}
  ]}

retroSrc と ditheredSrc には、別途用意した PNG を指定できます。レトロカラーは
小さな画素と少ない色、グレースケールのディザは白黒の模様で表現します。オリジナル
では公開された元画像を表示します。変換版がなければ元画像に戻ります。この設定は
ゲスト内の新しい画像を変換しません。両方の表現をサイトのビルド時に準備します。

パッケージと root
  sudo su
  apk --no-progress add --no-cache curl
  curl --fail --silent --show-error https://example.com/

パズルは /home/guest/start-here.txt から始まります。root はこの訪問者の Alpine
ゲスト内だけの権限です。通信は公開 IPv4 の TCP ポート 80 と 443 に対応します。
パッケージ署名と HTTPS 証明書の検証は有効なままです。

一時セッションについて
編集、パッケージ、画像、権限は、このセッションだけのものです。「新しいセッション」
で破棄され、公開済みの初期状態に戻ります。公開したい変更はプロジェクトの content
ソースで行ってください。端末とゲスト内ファイルは英語のままです。