HN público: HTML para pessoas

• HTML for People é um webbook para iniciantes que ajuda até pessoas de fora da indústria de tecnologia a criar sites diretamente com HTML
• Enxerga o HTML como um formato de documento da web que qualquer pessoa pode usar e o toma como ponto de partida para criar sites
• Foi estruturado para que mesmo quem não tem experiência em criação de sites ou programação possa acompanhar a proposta de criar um site do zero
• Blake Watson cria sites desde o começo dos anos 2000 e escreveu o livro com a ideia de que qualquer pessoa deveria poder aprender HTML
• Foca em abordar o conteúdo necessário de forma acessível e amigável, reduzindo a barreira de entrada para iniciantes

---

HTML que qualquer pessoa pode usar

• HTML não é uma ferramenta exclusiva de quem trabalha com tecnologia, mas um formato aberto a qualquer pessoa que queira criar seu próprio site
• Ao entender o HTML como um tipo de documento que compõe a web, é possível começar a criar sites sem ferramentas complexas

Um webbook para iniciantes

• HTML for People é um webbook amigável para iniciantes, que pode ser acompanhado até por quem não tem experiência com criação de sites ou programação
• Blake Watson cria sites desde o começo dos anos 2000 e, mesmo trabalhando em sua área profissional, acredita que qualquer pessoa deveria ser capaz de criar um site com HTML
• O livro orienta sobre o conteúdo necessário para começar de forma acessível e amigável

[GN⁺]

Comentários no Hacker News

• Boa a escolha de não lidar diretamente com CSS e se apoiar em https://simplecss.org/. CSS é uma área completamente diferente, então colocá-lo em cima do HTML básico pode ser bem pesado
  Ainda assim, o “Passo 1. Criar uma pasta no computador” em https://htmlforpeople.com/zero-to-internet-your-first-websit... me preocupa um pouco. Hoje em dia parece haver bastante gente que não entende nada de arquivos e pastas: https://www.theverge.com/22684730/students-file-folder-direc...
  Por outro lado, usar um capítulo inteiro do livro para explicar arquivos e pastas parece redundante; seria bom ter algum bom material introdutório para linkar

  • É surpreendente o quanto a epidemia mobile piorou. Mesmo entre estudantes que entram em Ciência da Computação, há casos de gente que não sabe descompactar um zip ou não consegue encontrar onde está um arquivo baixado
    Para constar, os estudantes desse tipo que conheço largaram o curso antes do segundo ano
  • Não saber o que são arquivos e pastas... por aqui estou balançando o punho e insistindo que isso não é uma “pasta”, é um diretório ;)
  • Sempre fiquei um pouco decepcionado com a forma como a maioria dos navegadores renderiza páginas HTML sem informações explícitas de estilo
    Não quero dizer que os padrões do navegador devam ter uma opinião tão forte quanto o simple.css, mas as margens, o padding, o estilo de fonte, os títulos etc. padrão não são exatamente atraentes
    Desenvolvedores web com gosto bem definido vão sobrescrever os padrões, sejam eles quais forem, mas fico me perguntando se teríamos mais sites pessoais e blogs em HTML puro se padrões mais bonitos fossem a convenção
  • O começo do fim foi quando, ao abrir um app ou web app, eles passaram a mostrar uma lista de documentos recentes em vez de abrir um novo documento
    Se você precisava de um arquivo, bastava abrir o app daquele arquivo e rolar para baixo, então não havia necessidade de entender o modelo em que arquivos existem de forma independente dos apps e podem ser criados ou vistos dentro deles
    Acho que a falta de um gerenciador de arquivos no iOS consolidou essa tendência
  • Não acho que isso seja uma questão geracional. Está mais para uma epidemia de pura preguiça
    O modelo mental de “jogar tudo mais ou menos junto no cesto de roupa e pegar quando precisar”, ou a fala de “tento organizar, mas quando há arquivos demais vira uma bagunça”, mostram bem isso
    Como muita gente no HN, sou bastante familiarizado com computadores e também tentei evitar o modelo de arquivos/pastas, mas no fim não encontrei um jeito. Por mais “avançadas” que pareçam, as outras abordagens desmoronam
    LLMs talvez mudem isso, mas até agora não existe uma forma de o computador prever o que eu quero e não quero e organizar por mim

• Vejo a abordagem básica deste projeto como algo muito valioso para o mundo
  Esse tipo de educação em padrões abertos pode ser uma ferramenta poderosa para nos afastar de empresas enormes e opacas e voltar ao sistema baseado em padrões abertos sobre o qual a internet começou
  Espero que continue sendo atualizado e que mais pessoas vejam e contribuam. Se você pensa parecido, seria bom ao menos dar uma estrela no GitHub: https://github.com/blakewatson/htmlforpeople
  Para constar, até agora não tenho nenhuma relação com este projeto e não ganho nada dizendo isso

  • A Mozilla tem uma documentação excelente há anos
    Também há uma seção de tutorial básico de HTML: https://developer.mozilla.org/en-US/docs/Learn/HTML
    Não é como se alguém estivesse impedindo as pessoas de aprender HTML
  • Espero muito que seja assim. Fico imaginando o que aconteceria se pessoas comuns sentissem que aprender HTML também é uma alternativa prática e útil para atingir seus objetivos, em vez de passar dezenas de horas aprendendo WordPress ou MS Word
  • Sou o OP. Obrigado pelas palavras gentis. Espero que este material chegue às mãos de não especialistas

• Ficou bem feito. Gosto muito da forma como primeiro mostra que você pode escrever texto puro, publicar e isso já funciona, para então passar naturalmente para HTML
  O texto também é claro, acolhedor e bem estruturado, então parece fácil e agradável de ler. Acredito que colocar HTML nas mãos de não especialistas é um bom objetivo
  Para dar alguns feedbacks: o conteúdo sobre codificação de caracteres parece aparecer bem tarde. Pessoas acostumadas com inglês, mas que querem escrever um site em sua própria língua, ou pessoas cujo nome tem acentos, podem se surpreender. Em vez de dizer apenas que é para caracteres especiais como emojis, seria melhor dizer que é essencial para a maioria dos idiomas que não sejam ASCII puro
  As tags body, head e html na maioria das vezes podem ser omitidas, mas html é útil por causa do atributo lang, tanto para acessibilidade quanto para evitar sugestões incorretas de tradução em alguns navegadores
  O VS Code é um pouco decepcionante por causa da telemetria e parece pesado e complexo demais para a tarefa. No Windows, Notepad++ é uma boa opção; no Linux, o editor de texto instalado por padrão é suficiente. Também existe o Codium, sem as partes ruins. O público-alvo não conhece essas partes ruins, então acaba instalando spyware sem perceber
  Eu não conhecia o recurso aria-current="page", mas acho que vou começar a usá-lo daqui em diante

  • Para colocar essa tag, não seria preciso antes configurar o editor de texto para salvar em UTF-8? Por exemplo, o Notepad, como outras coisas do Windows, não usa UTF-16 por padrão?
  • A grande complexidade aqui é que as pessoas não conhecem o conceito de codificação de caracteres em si. Por isso é difícil esperar que salvem index.html em UTF-8 desde o começo
    Por exemplo, o Windows Notepad provavelmente usa por padrão a página de código ativa. Se for possível tratar também do problema ao salvar, concordo que esse conteúdo deveria aparecer com mais destaque

• A ideia é realmente boa e é ótimo ver mais sites assim, mas acho que ela pressupõe um nível de letramento digital difícil de esperar de usuários comuns não técnicos
  A etapa 1 começa com “Escolha um local no seu computador e crie uma pasta. Dê a ela um nome como my-site”, e é aí que você já pode perder a maioria das pessoas
  Há uma quantidade surpreendente de gente que usa computador todos os dias e ainda assim não sabe fazer isso

  • Acho estranho esse ponto continuar sendo enfatizado nesta thread
    É difícil acreditar que alguém que usa computador todos os dias não saiba criar uma pasta. Até minha mãe, que quase não usa computador, sabe o que são pastas e arquivos
    Quem não sabe o que são arquivos e pastas não teria dificuldade para ser beneficiário imediato deste guia? Antes disso, precisaria aprender coisas muito mais básicas
  • É bem provável que muitos usuários do HN também tenham visto a página em dispositivos móveis, e não estivessem em condições de seguir as instruções na hora
  • Se isso for verdade, é muito triste. As pessoas regrediram tanto assim? Mesmo quando eu era criança, conseguia seguir essas instruções e, de fato, fiz meu próprio site aos 10 anos
    Será que a situação é mesmo tão grave, ou estamos partindo de desconfiança demais em relação às pessoas? Foi porque tudo passou a ser feito em apps na nuvem?
  • Sou o OP. Eu também fiquei um pouco preocupado com essa parte e até mencionei isso na introdução, mas acho que preciso abordar melhor
    Estou pensando se devo escrever e hospedar meu próprio material introdutório sobre criação de arquivos e pastas, ou então linkar para algum material básico desse tipo

• Já tentei convencer várias vezes pessoas não técnicas de que elas também podem criar seu próprio site com muita facilidade, mas geralmente elas acham que é piada ou que exige um esforço enorme
  Da próxima vez, pretendo mostrar este site e pedir que invistam só 30 minutos para ver o que conseguem criar nesse tempo. Sei que muita gente vai se empolgar assim que sentir aquele primeiro gostinho de “uau, eu realmente publiquei algo na web!”
  @blakewatson: você tem planos de adicionar internacionalização ao site e aceitar pull requests de tradução?

  • Tenho! Eu realmente quero fazer isso. Preciso atualizar o README, mas estou pensando numa estratégia de colocar os capítulos traduzidos em subpastas como /es
    Dá para configurar o Eleventy para gerar menus de navegação diferentes conforme o subcaminho
  • As escolas deveriam mesmo ensinar esse tipo de coisa. No ensino médio e na faculdade, criei vários sites pessoais, e era só HTML e um pouco de CSS
    Acho que esse deveria ser o primeiro passo de todo mundo. É uma ótima maneira de escrever algo e ver o resultado de forma rápida e fácil. Nem servidor precisa

• Por que “Start coding already!”? Algo como “Start writing already?” não seria melhor?
  Metade da barreira que dificulta as pessoas a criarem sites é acharem que precisam saber programar, e isso assusta. Por outro lado, elas sabem sobre o que querem escrever, então isso é muito mais acessível

  • Mudei para “Get started already” :)
  • Sou o OP. Ah, boa sugestão. É difícil tirar o chapéu de desenvolvedor web e olhar com olhos novos. Mesmo tendo tentado fazer isso conscientemente

• Gosto do fato de começar com um pequeno arquivo HTML e não mandar instalar logo de cara NodeJS, VS Code e todo tipo de tralha de desenvolvimento web

  • É uma lição que muitos profissionais precisam reaprender. Você realmente não precisa de centenas de MB de JavaScript para exibir texto e imagens básicos
    Acessibilidade e degradação elegante são ignoradas com frequência demais

• Gosto da ordem do tutorial, que primeiro faz a pessoa publicar algo de forma simples
  Você cria um index.html em texto puro no Notepad/TextEdit, publica em algum lugar como o Neocities e depois adiciona conteúdo com título e imagens
  Só depois ele coloca head, body etc. para transformar aquilo em HTML adequado, e segue o fluxo de fazer upgrade do Notepad/TextEdit para o Visual Studio Code

  • Você provavelmente já sabe, mas no HTML5 html, head e body são opcionais, então, mesmo sem eles, é um documento válido

• Excelente iniciativa, e a execução também é muito boa. Vou deixar nos favoritos para compartilhar com outras pessoas
  Recentemente, decidi adicionar conteúdo ao meu site usando apenas HTML escrito à mão e ir migrando aos poucos os textos antigos. Gosto do fato de o HTML ser direto, facilitar alterações pontuais por página e ser robusto
  Depois de usar praticamente todos os sistemas para publicar na web, concluí que, mesmo com um pouco mais de trabalho no começo, HTML é a ferramenta certa para esse serviço
  Como desenvolvedor aposentado, quando estou com vontade mexo em coisas como Rust, SQL ou embarcados, mas, quando quero escrever, só quero escrever. O HTML torna isso possível até certo ponto
  Se mais pessoas vissem HTML como um documento a ser escrito, e não apenas como um alvo de build, os sistemas ficariam muito mais simples. A mentalidade atual desacelerou muito o usuário médio de computador/web e também criou grandes dores de cabeça para desenvolvedores
  Não sei a quem ajuda, em 99% dos casos, a complexidade que trouxemos ao mundo. Este material pode ser uma das coisas que nos empurram de volta para o lugar certo