wikiotics.org
1.0.0
A Wikiotics é um site para aprender uma língua estrangeira.
O projeto Wikiotics foi fundado em 2008 com o objetivo de criar um wiki licenciado livremente, onde as pessoas poderiam colaborar com materiais para alunos de idiomas. Como parte disso, construímos um mecanismo wiki chamado ducto, que forneceu uma estrutura para criar páginas wiki interativas a partir de conteúdo estruturado, editável no navegador da web. Em 2011, a Wikiotics uniu forças com o Projeto Wikibabel, um projeto com uma visão semelhante e cujo desenvolvedor contribuiu com significância para a Wikiotics. Alguns anos depois, perdemos o interesse em manter o duto e ficamos ocupados com outras atividades.
Em julho de 2020, a Wikiotics foi transferida para um local estático. Embora tenha sido um wiki, o wikiotics.org recebeu contribuições de 62 usuários logados, bem como usuários anônimos identificados apenas por seu endereço IP. Houve um total de 4064 contribuições, cada uma com uma confirmação correspondente neste repositório (solicitação de puxar nº 4). Este repositório foi projetado para servir como um arquivo de trabalho do trabalho da comunidade. O desenvolvimento de novos conteúdos também é possível, com interesse suficiente.
O conteúdo é uma bagunça, como seria de esperar de um repositório editável por qualquer pessoa no mundo, sem moderação. Além disso, a única maneira real de ver um rascunho de uma lição foi salvá -lo no wiki.
O primeiro passo em frente é limpar o conteúdo. As lições e páginas que não são úteis devem ser excluídas. (Eles permanecerão na história do Git, se quisermos referenciá -los.) Qualquer lição em andamento que ainda não seja útil possa ser marcada com draft = true e, portanto, oculta da construção do site principal. Quando várias cópias do mesmo conteúdo são consolidadas, um alias deve ser deixado em qualquer local antigo, pois há muito tempo seguimos o princípio de que os URIs legais não mudam.
Qualquer pessoa que contribuiu para o Wiki e tenha uma conta no GitHub pode reivindicar suas contribuições enviando uma solicitação de tração que adiciona uma entrada apropriada ao arquivo .mailmap neste repositório. Esta entrada deve mapear [email protected] para um endereço de e -mail associado à conta do github da pessoa (ou, alternativamente, ao endereço [email protected] ).
A reivindicação de contribuições dessa maneira significa que o perfil do usuário está vinculado no histórico do Github de qualquer página que a pessoa contribuiu para (exemplo aqui). Infelizmente, no momento, parece que o gráfico de contribuições não considera o arquivo .mailmap . Isso é inconsistente com um relatório sobre o excesso de pilha, mas provavelmente está relacionado a essa discussão na instância do discurso do Github. Curiosamente, o aplicativo FastHub-Libre exibe o gráfico de contribuições corretamente, em sua totalidade.
A Wikiacics agora é um local estático construído com Hugo. As etapas a seguir permitem editá -lo localmente:
Instale Hugo.
No Ubuntu, isso é tão simples quanto
$ sudo snap install hugo --channel=extended
No momento, a versão "estendida" não é necessária, mas podemos experimentar seus recursos no futuro.
Clone este repositório:
$ git clone https://github.com/wikiotics/wikiotics.org.git
Inicie o servidor de desenvolvimento Hugo e aponte um navegador da web para o URL fornecido:
$ cd wikiotics.org
$ hugo server
[...]
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
O conteúdo está no content/ diretório. Ao salvar qualquer arquivo de conteúdo, o navegador da Web deve atualizar automaticamente com o conteúdo atualizado.
Cada lição é representada inteiramente pelo Toml Front Matter, que está contido entre as linhas que dizem +++ . Ao editar uma lição, uma dica é definir temporariamente grid = true em sua matéria frontal, que exibirá os elementos da lição como uma planilha. Isso pode ser útil para obter uma visão global da lição. As lições para as quais draft = true também serão exibidas como uma grade (ou seja, se os rascunhos estiverem ativados).
Cada lição pode ser anotada com o idioma que ensina e, se aplicável, o idioma que assume que o aluno sabe definindo target-languages e/ou source-languages no assunto da lição, seguindo as definições padrão desses termos. Nos bastidores, essas anotações são casos de taxonomias de Hugo.
O esquema de nomeação do Wiki (para URLs/rotas) está em discussão no #12. Também planejamos documentar (#9) e melhorar (#10) as estruturas de dados do TOML para lições.
A maior prioridade no momento é melhorar a apresentação do arquivo do site.
Atualmente, a adição de novas lições meios de lição envolveria alterações de coordenação com o repositório de mídia da Wikiacs. Existem duas alternativas em consideração: GIT GRANDE ARQUIVO DE ARQUIVO E IPFS (detalhes em #15).
Todo o conteúdo (ou seja, tudo no content/ diretório, recursivamente) é licenciado sob a licença Creative Commons Attribution-ShareAlike 3.0. Algumas das mídias da lição (referenciadas, mas não incluídas neste repositório) estão disponíveis em uma licença diferente (mas gratuita) do Creative Commons. Todo o resto (por exemplo, todo o código) está disponível na versão 3 da Licença Pública Geral 3 da GNU ou em qualquer versão posterior. Algumas das bibliotecas em {assets,static}/ductus/ estão disponíveis sob licenças mais permissivas.
Gostamos de simplificar as coisas, após anos de ter uma pilha de tecnologia bastante complicada. (Mesmo antes, conseguimos evitar muitos dos excessos do desenvolvimento moderno do front -end.) Manter as coisas simples ajuda a maximizar o fator de ônibus e minimizar o tempo gasto na manutenção do local. Não deve haver poucas peças móveis e, idealmente, nenhum servidor para manter.
Nós desenvolvemos as seguintes peças de tecnologia para ajudar a atingir nossos objetivos:
