Giter Club home page Giter Club logo

cefet-web-weblot's Introduction

O Reino de Weblot 👑

Um conjunto de códigos ilustrativos de APIs do HTML5 (⬅️ clicar).

Instruções

Conforme o enunciado diz, o trabalho é composto pela criação, entrega e apresentação de um projeto de código simples ilustrando cada API escolhida pelo grupo.

O projeto deve ser entregue como um Pull Request (veja [1] e [2]) neste repositório. Ou seja, um (01) membro do grupo deve:

  1. Fazer um fork deste repositório e dar permissão de escrita (commit/push) para todos os membros do grupo;
    • Clicar no botão fork e, depois, clicar no Settings e procurar
  2. Trabalhar no branch com nome 'ano/semestre' (e.g., 20YY/SS). Por exemplo, se for em 2030/01:
    git checkout -b 2030/01
    
  3. Para cada exemplo que se pretende criar, você deve criar dentro da pasta /apis uma pastinha com o nome da sua API de escolha (nome em minúsculo, sem acentos, trocando espaços por de hífens e sem o prefixo ou sufixo API - e.g., /apis/drag-and-drop/) e colocar   seu código lá.
    • Se optar por ilustrar mais de uma API em um mesmo exemplo, dê um nome à pasta resumindo todas as APIs usadas. Por exemplo, para APIs de Canvas e Speech Recognition, o nome da pasta seria apis/canvas-e-speech-recognition/.
  4. Cada pasta de exemplo deve conter:
    1. Uma screenshot (preferencialmente quadrada e nor formato .webp)
    2. Arquivo README.md seguindo o modelo de apis/drag-and-drop/README.md
    3. Arquivo apis.json seguindo o modelo de apis/drag-and-drop/apis.json, que é um vetor com os dados de cada API usada no seu exemplo. Formato de um apis.json:
      [
        {
          "nome": "Drag and Drop API",
          "breveDescricao": "Possibilita o arraste de elementos HTML em cima de outros",
          "paginaInicial": "apis/drag-and-drop/",
          "screenshot": {
            "caminho": "apis/drag-and-drop/images/screenshot.png",
            "textoAlternativo": "Uma página com 2 monstrinhos em uma jaula e outros 3 fora com os dizeres 'Prenda os Monstrinhos'"
          },
          "desenvolvedores": [
            {
              "nome": "Flávio Coutinho",
              "usuarioGithub": "fegemo"
            }
          ],
          "suporteDeNavegadores": {
            "chrome": true,
            "safari": true,
            "firefox": true,
            "ie": false,
            "edge": true,
            "opera": true
          }
        },
        {
          "nome": "SEGUNDA API DO MESMO EXEMPLO",
          "breveDescricao": "MINHA DESCRIÇÃO... etc."
        }
      ]
      • Sobre o suporte de navegadores, consulte alguma fonte como o caniuse.com para preencher.
  5. Alterar o arquivo examples.json (na raiz) colocando os nomes das pastas de exemplos (só o nome, não o caminho) que o grupo criou (sem remover a que está lá). Insira a(s) string(s) com nomes de pasta sendo 1 por linha e em ordem alfabética - apenas para tentar reduzir o número de conflitos nesse arquivo ao entregar seu pull request. Por exemplo, para incluir os exemplos apis/battery-status/ e apis/webvr:
    • Inicialmente estava assim:
      {
        "semestre": "2030/01",
        "pastas": [
          "drag-and-drop"
        ]
      }
    • Ficou assim:
      {
        "semestre": "2030/01",
        "pastas": [
          "battery-status",
          "drag-and-drop",
          "webvr"
        ]
      }
  6. Abra um servidor web na pasta raiz e veja se está tudo funcionando (verifique o console para erros)
  7. Quando tudo estiver certo, abra o pull request do seu branch 20XX/SS contra o branch de mesmo nome do repositório do professor

Os membros de um mesmo grupo devem trabalhar no fork criado por apenas 1 integrante, ou seja, aquele que criou o fork deve dar permissão de escrita ao(s) outro(s).

Veja o projeto de exemplo que já está lá, sobre a API de drag and drop: código fonte e o exemplo publicado. Pessoas bonitas seguem a mesma ideia e formato (exemplo simples, porém bonitão, criativão e on-topic).

Enviando

Como mencionado, o envio será via um pull request. Assim que você der o último git push para o seu fork, vá para a página do seu fork no Github e clique em "Pull Request":

Nessa tela, você deve escolher:

  • como origem: o seu branch (ano/semestre);
  • como estino: o branch (ano/semestre) do repositório original como destino (e não o master).

cefet-web-weblot's People

Contributors

daniel-hasan avatar fegemo avatar sarahrms avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.