HN公開: 人々のためのHTML

 (htmlforpeople.com)
4 ポイント 投稿者 GN⁺ 2024-10-11 | 1件のコメント | WhatsAppで共有
  • HTML for People は、技術業界の外にいる人でも HTML で直接ウェブサイトを作れるよう支援する、初心者向けのウェブブック
  • HTML を誰もが扱える ウェブの文書形式 と捉え、ウェブサイト制作の出発点とする
  • ウェブサイト制作やコーディングの経験がなくても、ゼロからウェブサイトを作ること を追っていけるよう構成されている
  • Blake Watson は 2000年代初頭からウェブサイトを作ってきており、誰もが HTML を学べるべきだという考えから本を書いた
  • 必要な内容を 親しみやすく取り組みやすい形 で扱うことに重点を置き、入門者のハードルを下げている

誰もが扱えるHTML

  • HTML は技術分野の従事者だけの道具ではなく、ウェブサイトを自分で作りたい人なら誰にでも開かれた形式
  • ウェブを構成する 文書形式 として HTML を理解すれば、複雑なツールがなくてもウェブサイト制作を始められる

初心者のためのウェブブック

  • HTML for People は、ウェブサイト制作やコーディング経験のない人でも読み進められる、初心者にやさしいウェブブック
  • Blake Watson は 2000年代初頭からウェブサイトを作っており、専門分野で働く一方で、誰もが HTML でウェブサイトを作れるべきだと考えている
  • 本は、始めるために必要な内容を 親しみやすく取り組みやすい形 で案内している

関連記事

1件のコメント

 
GN⁺ 2024-10-11
Hacker News の意見

  • CSS を直接扱わず、https://simplecss.org/ に頼る選択は良い。CSS はまったく別の領域なので、基本的な HTML の上に載せるとかなり負担になり得る
    ただし、https://htmlforpeople.com/zero-to-internet-your-first-websit... の「ステップ 1. コンピューターにフォルダーを作る」は少し気になる。最近はファイルとフォルダーをまったく理解していない人がかなり多いように見えるからだ: https://www.theverge.com/22684730/students-file-folder-direc...
    とはいえ、本の 1 章まるごとをファイルとフォルダーの説明に使うのは重複のように感じるので、代わりにリンクできる良い入門資料があるとよさそう

    • モバイル流行病がどれほど深刻になったかには驚く。コンピューターサイエンス専攻で入ってくる学生の中にも、zip を展開する方法や、ダウンロードしたファイルがどこにあるか分からないケースがある
      ちなみに、私の知っているそういう学生たちは 2 年生になる前に中退した
    • ファイルとフォルダーを知らないなんて、こちらでは拳を振り上げながら、それは「フォルダー」ではなく ディレクトリだと言い張っている ;)
    • 明示的なスタイル情報がない HTML ページを、ほとんどの Web ブラウザーがレンダリングする方法には、いつも少しがっかりしていた
      ブラウザーのデフォルトが simple.css ほど強い好みを持つべきだという意味ではないが、デフォルトの余白、パディング、文字スタイル、見出しなどは特に魅力的ではない
      好みがはっきりした Web 開発者はデフォルトが何であれ上書きするだろうが、もっと見栄えのするデフォルトが慣例だったなら、純粋な HTML の個人サイトやブログがもっと生まれていたのではないかとも思う
    • アプリや Web アプリを開くとき、新しい文書を開く代わりに 最近使った文書の一覧を表示し始めたのが終わりの始まりだった
      ファイルが必要なら、そのファイル用のアプリを開いて下にスクロールすればよかったので、ファイルがアプリとは独立して存在し、アプリの中で作られたり見られたりするというモデルを理解する必要がなかった
      iOS にファイルマネージャーがなかったことが、この流れを固めたのだと思う
    • これは世代の問題だとは思わない。単に純粋な 怠惰が流行病のように広がったものに近い
      「すべてを洗濯かごに雑に一緒に入れておき、必要なときに取り出す」という思考モデルや、「整理しようとはするが、ファイルが多くなりすぎるとめちゃくちゃになる」という言葉が、それをよく示している
      HN の多くの人のようにコンピューターにはかなり慣れているし、ファイル/フォルダーモデルを避けようともしてみたが、結局方法は見つからなかった。どれほど「高度」に見えても、他のやり方は崩壊する
      LLM が変える可能性はあるが、これまでのところ、コンピューターが私の望むものと望まないものを予測して整理してくれる方法はない

  • このプロジェクトの基本的なアプローチは、世の中にとって非常に価値があると思う
    こうした オープン標準の教育こそ、巨大で不透明な企業から離れ、インターネットが始まったころのオープン標準ベースのシステムへ戻るための強力な道具になり得る
    継続的に更新され、より多くの人が見て貢献してくれるといい。同じ考えなら、少なくとも GitHub のスターだけでも押してほしい: https://github.com/blakewatson/htmlforpeople
    ちなみに、私はこのプロジェクトとは今のところ何の関係もなく、こう言って得るものもない

    • Mozilla には何年も前から優れたドキュメントがある
      基本的な HTML チュートリアルのセクションもある: https://developer.mozilla.org/en-US/docs/Learn/HTML
      人々が HTML を学ぶのを誰かが妨げていたわけではない
    • 本当にそうなってほしい。WordPress や MS Word の使い方を何十時間も学ぶ代わりに、一般の人が HTML を学ぶことも目標達成のための実用的で有用な選択肢だと感じたら、何が起きるのか気になる
    • OP です。温かい言葉をありがとう。この資料が 非専門家の手に届いてほしい

  • よくできている。プレーンテキストを書いて公開すればすぐ動くことを先に見せてから、HTML へ自然に移っていくやり方が本当に良い
    文章も明確で歓迎する雰囲気があり、構成もしっかりしていて読みやすく、楽しく読めそうだ。HTML を非専門家の手に渡すのは良い目標だと思う
    フィードバックをいくつか挙げると、文字エンコーディングに関する内容がかなり後のほうに出てくるように思う。英語には慣れているが自分の言語で Web サイトを書こうとする人や、名前にアクセント記号がある人は驚くかもしれない。絵文字のような特殊文字用だと言うだけでなく、純粋な ASCII ではないほとんどの言語には必須だと言ったほうがよい
    body, head, html タグはほとんどの場合なくてもよいが、html は lang 属性により、アクセシビリティや一部ブラウザーの誤った翻訳提案を防ぐうえで有用だ
    VS Code はテレメトリのため少し残念で、作業内容に対して重く複雑に見える。Windows では Notepad++ が良い選択肢で、Linux では標準搭載のテキストエディターで十分だ。悪い部分を取り除いた Codium もある。対象読者はこうした悪い部分を知らないので、知らないうちにスパイウェアをインストールすることになる
    aria-current="page" 機能は知らなかったが、今後使い始めそうだ

    • そのタグを入れるには、そもそもテキストエディターで UTF-8 で保存するよう設定しなければならないのでは？ たとえば Notepad は、Windows の他のものと同じようにデフォルトで UTF-16 を使うのではないか？
    • ここで大きな複雑さは、人々が 文字エンコーディングそのものを知らないことにある。だから index.html を最初から UTF-8 で保存するとは期待しにくい
      たとえば Windows Notepad はデフォルトでアクティブなコードページを使うはずだ。保存の問題まで一緒に扱えるなら、この内容はもっと目立つ形で入れるべきだという点には同意する

  • アイデアは本当に良いし、こういうサイトが増えるのも歓迎だが、一般的な非技術系ユーザーには期待しにくいレベルのコンピューターリテラシーを前提にしていると思う
    ステップ1が「コンピューター上で場所を選び、フォルダーを作成してください。my-site のような名前を付けてください」から始まるが、ここで既に大多数の人を失う可能性がある
    毎日コンピューターを使っていても、これをどうやるのか知らない人が驚くほど多い

    • このスレッドでこの点が繰り返し強調されているのは不思議に感じる
      毎日コンピューターを使っている人がフォルダーの作り方を知らないというのは信じがたい。コンピューターをほとんど使わないうちの母でさえ、フォルダーとファイルが何かは分かっているはず
      ファイルやフォルダーが何か分からない人は、このガイドの直接の受益者にはなりにくいのでは？ その前に、もっとずっと基本的なことを学ぶ必要がある
    • HNユーザーのかなりの数もモバイル端末でページを見ていた可能性が高く、指示をすぐに実行できる状況ではなかったのだと思う
    • これが本当ならとても悲しい。人々はここまで衰えてしまったのか？ 私は子どものころでもこの指示に従えたし、実際に10歳のときに自分のウェブサイトを作った
      本当にそこまで深刻なのか、それとも人々を疑いすぎているだけなのか？ すべてをクラウドアプリで処理するようになって、こうなったのか？
    • OPです。私もこの部分は少し心配していて、導入である程度触れはしたが、もっと扱う必要がありそう
      ファイルとフォルダーの作り方の入門資料を自分で書いてホストするか、そうした基礎資料へリンクするかを検討中

  • 非技術者にも自分のウェブサイトはとても簡単に作れると何度も説得してみたが、たいてい冗談だと思われるか、とんでもない労力が必要だと考えられる
    次はこのサイトを見せて、30分だけ使ってその時間内に何が作れるか見てみてと言うつもり。「わあ、自分が実際のウェブに何かを公開したんだ！」という最初の味を知れば、ハマる人は多いはずだと分かっている
    @blakewatson: サイトに国際化を追加して、翻訳のプルリクエストを受け付ける予定はある？

    • ある！ 本当にそうしたい。READMEを更新する必要があるが、翻訳された章を /es のようなサブフォルダーに置く戦略を考えている
      Eleventyがサブパスに応じて別々のナビゲーションメニューを生成するよう設定できる
    • 学校では本当にこういうことを教えるべきだ。高校と大学で個人ウェブサイトをいくつも作ったが、ただのHTMLと少しのCSS程度だった
      みんなの最初の一歩はこうあるべきだと思う。何かを書いて、その結果を素早く簡単に見られる素晴らしい方法だ。サーバーすら必要ない

  • なぜ「Start coding already!」なのだろう？ 「Start writing already?」のような表現のほうが良くない？
    人々がサイト作りを難しいと感じる障壁の半分は、コーディングを知らなければならないと思っているからで、それは怖く感じられる。一方で、自分が何を書きたいかは分かっているので、はるかに取り組みやすい

    • 「Get started already」に変えた :)
    • OPです。ああ、良い提案だ。ウェブ開発者としての自分を脱ぎ捨てて新しい目で見るのは難しい。意識してそうしようとしていたのに、それでもこうなってしまう

  • 小さなHTMLファイルから始め、すぐにNodeJSやVS Codeやあらゆるウェブ開発の雑多なものをインストールしろと言わない点が良い

    • 多くの専門家が学び直すべき教訓だ。基本的なテキストと画像を表示するのに、数百MBのJavaScriptは実際には必要ない
      アクセシビリティと優雅な失敗は、あまりにも頻繁に無視されている

  • まず簡単にデプロイさせるチュートリアルの順序が良い
    Notepad/TextEditでプレーンテキストの index.html を作り、Neocitiesのような場所にデプロイし、その後タイトルや画像でコンテンツを追加する
    その次になって初めて head や body などを入れてきちんとしたHTMLにし、Notepad/TextEditからVisual Studio Codeへアップグレードする流れだ

    • 既にご存じだろうが、HTML5では html、head、body は省略可能なので、なくても妥当な文書だ

  • 素晴らしい試みで、実装もとても良い。他の人に共有するためにブックマークしておくつもり
    最近、自分のウェブサイトに手書きのHTMLだけで内容を追加し、過去の記事もゆっくり移すことにした。HTMLは直接的で、ページごとの一時的な変更がしやすく、堅牢なところが良い
    ウェブに公開するほぼすべてのシステムを使ってきた結果、最初に少し余計な手間がかかっても、HTMLがその仕事に合った道具だという結論に至った
    引退した開発者として、気が向いたときはRustやSQL、組み込みのようなものを触るが、文章を書きたいときはただ書きたい。HTMLはある程度それを可能にしてくれる
    もっと多くの人がHTMLを単なるビルド対象ではなく、書くための文書として見れば、システムはずっと単純になると思う。今の考え方は平均的なコンピューター/ウェブユーザーを大きく減速させ、開発者にも大きな厄介事を生み出した
    私たちが世の中に持ち込んだ複雑さが、99%の場合に誰の役に立っているのか分からない。この資料は、私たちを本来の場所へ押し戻すきっかけの一つになり得る