Nosso objetivo é levar informações às pessoas. Manter o design do site simples ajuda a cumprir isso.
Por favor, seja atencioso com todas as pessoas que acessam nossas páginas da web e acomode-as, incluindo aquelas que usam navegadores somente de texto ou navegadores antigos, bem como aquelas com conexões lentas. Desejamos evitar que o design HTML tenha uma ótima aparência em uma versão de um navegador e que seja feio em muitos outros. Claro, por favor, não instale nenhum dos navegadores de software proprietários disponíveis se você já não os usa.
/software/
que descrevem programas específicos. Pelos nossos
princípios, a documentação deve ser
livre. Portanto, essas páginas devem ter uma licença livre. Se essa
página não tiver uma licença livre, relate o problema para <webmasters@gnu.org>.index.html
deve ser usado apenas como um link simbólico, como explicado a seguir.index.html
para o arquivo HTML de nível superior desse
diretório. Use o arquivo .symlinks
para lidar com isso.ARTIGO.html
e suas traduções
ARTIGO.LANG.html
. A parte LANG deve conter o código de idioma
de duas letras de ISO 639
e, opcionalmente, um hífen seguido o código de país de duas letras dado na
ISO 3166. Por exemplo, a tradução em alemão de not-ipr.html
deve ser nomeada not-ipr.de.html
; a tradução em português
brasileiro deve ser nomeada não-ipr.pt-br.html
./
(por exemplo, /gnu/about-gnu.html
;
não http://www.gnu.org/gnu/about-gnu.html
e
não about-gnu.html
). Isso facilita copiar e colar
links de outras páginas. Além disso, links como
http://www.gnu.org/
estarão errados quando o visitante usar
HTTPS./gnu/gnu.html
, não apenas
/gnu/
. Nunca use index.html
em uma URL. Ambas são
gentilezas para o usuário, pois os navegadores alteram o realce em um link
após ele ter sido visitado. Se os links para um determinado arquivo usarem
várias URLs diferentes, as URLs que não foram explicitamente mencionadas não
serão destacadas como visitadas. Assim, o usuário acessa as páginas que ele
já viu, o que é irritante. Além disso, isso facilita a manutenção do site à
medida que as coisas são movidas.id
. <a
href=“https://ftp.gnu.org/gnu/foo”>https://ftp.gnu.org/gnu/foo</a>
README
, informações de quais
versões estão disponíveis, documentações, fontes, etc.). Além disso,
significa que as URLs de localização de FTP não precisam ser alteradas,
neste e em outros sites, à medida que novas versões são lançadas nesse
diretório. <a href=“https://www.stallman.org/”>Richard Stallman</a>
<a href=“mailto:rms@gnu.org”><rms@gnu.org></a>
http(s):
para outra página web e o que é uma âncora
mailto:
que abrirá um formulário de correio para preencher e
enviar, se isso for suportado pelo cliente. Além disso, se os usuários
salvarem uma cópia da página, eles terão uma cópia do endereço de e-mail que
podem usar sem voltar ao navegador web. Se a pessoa não tiver uma página
web, deixe o nome sem a âncora.
<link rev=“made” href=“mailto:webmasters@gnu.org”>
-
GNU Project - Free Software Foundation
.<acronym>
: HTML5 o tornou obsoleto em favor do
<abbr>
.<abr>
a menos que seja por um motivo realmente
convincente. Os navegadores o processam de maneira feia.<abbr title=“Abreviação Expandida”>AE</abbr>
ou
AE(Abreviação Expandida)
.AE
./reset.css
(da biblioteca
YUI, versão 2), que normaliza a renderização padrão de todos os
elementos HTML pelos vários navegadores e /layout.css
, que
contém formatação específica do gnu.org. Alguns elementos responsivos são
definidos em /layout.css
. Eles cobrem a maioria dos nossos
casos de uso./mini.css
. Esta folha de estilo é apenas as folhas de estilo
reset e base da YUI (versão 2), pois esses dispositivos normalmente têm
uma necessidade mínima de várias fontes e não precisam de layouts
sofisticados./print.css
. Observe que o cabeçalho, barras de
navegação e rodapé (exceto direitos autorais e licença) não são imprimíveis.header.html
e
banner.html
. Se o estilo se aplicar a um único elemento,
normalmente ele deve ser adicionado como um atributo./gnu.css
, que por sua vez carrega o /mini.css
,
já que essas páginas são geralmente muito básicas, simples páginas com pouca
ou nenhuma formatação./style.css
./style.LANG.css
) que
modificam layout.css de acordo com suas próprias necessidades. Os idiomas
RTL (árabe, persa e hebraico) usam /style.rtl.css
.<img src=“/graphics/*.jpg” alt=“ [TEXTO
DESCRITIVO] ”>
em
ou %
; por exemplo:
<img src=“/graphics/*.jpg” alt=“ [TEXTO
DESCRITIVO] ” style=“width: 10em” />
layout.css
(a folha de estilo para páginas
modeladas), você pode querer usar a classe imgright
ou
imgleft
(definida na seção IMAGES da folha de estilo). Isso
garantirá que a direção flutuante seja invertida se a página for traduzida
para um idioma RTL.pict
responsivas definidas na seção IMAGES do layout
.css
(você pode ajustar a largura em um atributo de estilo se
nenhum dos pré-definidos atender às suas necessidades); por exemplo:
<div class=“pict wide” style=“width: 25em”><img
src=“/graphics/*.jpg” alt=“ [TEXTO DESCRITIVO] ”
/></div>
div
é necessário porque alguns
navegadores (por exemplo, NetSurf) não sabem como aplicar
max-width
às imagens.Faça um link para todas as imagens exibidas em todo o site à página
relevante, geralmente em /graphics/
. Isso pode ser feito com
código semelhante a este, que corresponde à imagem à esquerda:
<p class=“imgleft”> <a href=“/graphics/agnuhead.html”> <img src=“/graphics/gnu-head-sm.jpg” alt=“ [Image of the Head of a GNU] ” style=“width: 8em” /> </a></p>Isso permitirá que os usuários acessem rapidamente as páginas relacionadas às fotos nas quais estão interessados.
Um dos aspectos mais complexos da manutenção de páginas web é seguir as diretrizes de links; no entanto, também é um aspecto crucial do trabalho.
Nós nos esforçamos para garantir que todas as páginas que promovemos – todas as páginas que recebem links em nosso site – sejam amigáveis ao movimento software livre. Algumas páginas obviamente não atenderão a esses padrões; se o site critica a Free Software Foundation, ou não tem relação aparente com o software livre e questões relacionadas, não deve-se acrescentar um link para ele. Além disso, no entanto, existem critérios usados para determinar se é ou não apropriado fornecer um link para uma página da nossa. Eles estão listados abaixo, em ordem decrescente de importância geral.
O propósito do link em nosso site terá um papel na determinação de quão fortemente ele deve ser julgado em relação aos outros critérios. Páginas hospedando projetos GNU serão julgadas com os mais altos padrões. Páginas sobre outros softwares livres e grandes promoções – por exemplo, incluídas em um feed de notícias na página principal – estão em segundo lugar. Os links na página de filosofia podem ter mais margem de manobra ao falar sobre software proprietário; As páginas do grupo de usuários GNU/Linux devem chamar o sistema quase sempre de GNU/Linux, mas dificilmente são verificadas em outros critérios. Tenha sempre isso em mente ao decidir como pesar cada aspecto dessas políticas.
A grande questão levantada pelo movimento software livre é que o software proprietário apresenta um dilema ético: você não pode concordar com termos não-livres e tratar os que estão à sua volta como gostaria de ser tratado. Quando softwares proprietários são promovidos, as pessoas ficam com a impressão de que não há problema em usá-los, enquanto tentamos convencê-las do contrário. Como tal, evitamos oferecer publicidade gratuita, seja diretamente em nosso site ou indiretamente por meio de links.
O que é complicado nesse critério é o ponto de “promoção”: há uma diferença entre mencionar software proprietário e fazer um discurso de vendas para ele. De fato, o site do Projeto GNU faz menção a software proprietário por toda parte, mas nunca dá às pessoas a impressão de que seu uso não apresenta problemas éticos.
Há duas coisas a ter em mente ao determinar se uma referência a um software proprietário o promove ou simplesmente o menciona. Em primeiro lugar, quanta informação é oferecida sobre o software? Segundo, quanta informação é provável que o leitor realmente ganhe com essa página?
Páginas diferentes fornecem diferentes quantidades de informações sobre software proprietário; quanto mais elas fornecem, mais problema elas representam para nós. Por exemplo, algumas páginas podem ser vinculadas ao site principal de um programa de software proprietário. Outros podem descrever sua funcionalidade em detalhes. Até mesmo o nome do produto é dado; há uma diferença entre “Windows” e “Microsoft Windows XP Home Edition”.
Se a página exigir JavaScript não livre e não trivial e houver falhas graves com o JavaScript desativado, o link não deverá ser criado. Da mesma forma, se a página incorporar o Flash que desempenha um papel importante, de modo que uma pessoa perderia algo importante se os vídeos não forem reproduzidos, o link não deverá ser criado.
O assunto da referência também terá um papel na determinação de quão problemática é uma referência. Se o software já é muito popular, é improvável que uma menção básica seja novidade para o leitor. Alguns exemplos de software proprietário que são comuns o suficiente para serem considerados “conhecidos” são os principais sistemas operacionais (Windows, Mac OS, SO Sun, HP-UX) e aplicativos comuns principais, como Office, Internet Explorer, Photoshop, Acrobat Reader e Flash.
As páginas de projeto dos softwares GNU sentem a força total desta política. O software proprietário deve ser mencionado apenas quando o software fornece suporte a ele ou para compará-lo com os recursos de software proprietário bem conhecido. Por exemplo, o texto a seguir – e não muito mais – seria aceitável:
w3 is a web browser for GNU Emacs, similar to Internet Explorer. It can run on all platforms GNU Emacs runs on, including GNU/Linux, proprietary Unix systems, and Windows. 1
Links que aparecem em outras áreas, como os depoimentos ou páginas de filosofia, bem como links para grupos de usuários podem discutir esse software em maior detalhe, mas links e outros métodos de incentivo para “aprender mais”. ainda devem ser evitados.
Quase todas as páginas que possuem links em nosso site devem, no mínimo, tratar software livre e código aberto igualmente. Não fazer isso – seja omitindo o software livre ou sugerindo que o código aberto é superior – geralmente é inaceitável. As páginas de projeto dos softwares GNU devem ter pouca menção a código aberto. A página do GNOME é usada para fornecer um bom exemplo de uma maneira diplomática de fazer isso:
GNOME is part of the GNU Project, and is free software (sometimes referred to as open source software). 2
Qualquer exceção a esta regra deve ser aparente no contexto. Por exemplo, as páginas dos grupos de usuários podem falar mais detalhadamente sobre código aberto; nós declaramos na página de grupos de usuários, “As with our links page, the FSF is not responsible for the contents of other websites, or how up-to-date their information is.” 3
As páginas para as quais acrescentamos link devem tratar bem o Projeto GNU. O principal aspecto a ser observado a esse respeito é se a página chama o sistema GNU/Linux ou apenas “Linux”. As páginas do projeto de software GNU e do grupo de usuários quase nunca, ou nunca, deixarão de fazer isso. Novamente, as exceções para outras páginas devem ser aparentes no contexto.
Isto posto, certas partes de uma página não devem ser consideradas contra esses critérios. Por exemplo, suponha que fôssemos fazer um link para uma página em um site de notícias de software livre. Quaisquer anúncios ou comentários de leitores anexados ao artigo não serão considerados ao determinar se ele atendeu ou vinculou as diretrizes, uma vez que elas são entendidas como a opinião de seus autores individuais. Da mesma forma, em páginas de grupos de usuários, o conteúdo de fóruns e páginas wiki não deve ter peso nesses aspectos.
Por fim, alguns sites são sempre considerados exceção com a maioria dessas diretrizes. Esses sites são geralmente sobre questões que são importantes, mas um tanto periféricas, para o movimento do software livre. Várias vezes acrescentamos link para o site da Electronic Frontier Foundation, embora eles incentivem o uso do Flash e falem exclusivamente sobre software livre. É geralmente entendido que, uma vez que estas páginas não são primariamente sobre software livre, as políticas não possuem força total para elas.
Como uma explicação final (vinda do RMS): Mesmo para fazer links a partir do www.gnu.org, nós não exigimos que as pessoas chamem o sistema GNU/Linux ou usem o termo “software livre” em vez de “open source”. No entanto, exigimos que eles não promovam nenhum software não-livre.
Se tudo isso parece complicado, é porque, infelizmente, é. Não se preocupe; um talento para isso vem com o tempo e a experiência. Você pode avaliar erroneamente algumas páginas enquanto aprende a ter uma ideia do que é aceitável e do que não é; Por favor, não hesite em receber uma segunda opinião de um webmaster mais experiente, ou alguém como o Chief Webmaster ou o RMS. Novas exceções sempre surgirão; mantenha uma mente aberta para essa possibilidade e esteja preparado para lidar com eles adequadamente.
CVS_RSH=ssh
.Se você tem acesso de escrita a www, confira o principal repositório www com seu login em Savannah:
cvs -z3 -d:ext:<nome-de-usuário>@cvs.savannah.gnu.org:/web/www co www
Você receberá um diretório de trabalho, www
, com a mesma
estrutura do nosso site principal.
Se você não tiver acesso de escrita a www, ainda poderá fazer um checkout anônimo de www:
cvs -z3 -d:pserver:anonymous@cvs.savannah.gnu.org:/web/www co www
Faça o checkout do repositório da web do projetofoo:
cvs -z3 -d:ext:<nome-de-usuário>@cvs.savannah.gnu.org:/web/projetofoo co projetofoo
Você obterá um diretório de trabalho, projetofoo
, com a mesma
estrutura que o subdiretório www/software/fooproject
. Note, no
entanto, que os repositórios projetofoo e www são independentes. Os
diretórios de trabalho podem estar em qualquer lugar no seu sistema de
arquivos.
Webmasters, por favor leiam as Páginas web para software GNU oficial antes de enviar qualquer coisa para o repositório web de um projeto de software.
Adicione um arquivo ou diretório:
cvs add foo
Atualize antes de editar um arquivo:
cvs update -P foo
Verifique as alterações que você vai enviar:
cvs diff -U2 foo
Execute o commit (sem necessidade de cvs add
se o arquivo já
estiver no repositório):
cvs commit foo
Isso abrirá um editor de texto no qual você deverá inserir uma mensagem de log. A confirmação ocorrerá ao salvar a mensagem.
Sem serem excessivamente detalhados, as mensagens de log devem descrever com a maior clareza possível a natureza do commit, incluindo quaisquer números de tickets relacionados do RT, para permitir que futuros historiadores entendam por que suas alterações foram feitas.
Sempre que possível, as alterações em vários arquivos que compartilham a mesma mensagem de log devem ser agrupadas em uma confirmação. Não agrupe várias alterações não relacionadas em um commit.
As alterações (exceto para arquivos .symlinks) devem estar visíveis em www.gnu.org em poucos minutos.
Para mais detalhes sobre o CVS, como reverter para uma versão anterior, ou
olhar para a saída diff
de uma mudança particular, veja a Documentação do CVS.
Como o CVS não é capaz de manipular links simbólicos diretamente, um mecanismo separado foi implementado para permitir que os webmasters mantenham links simbólicos, como segue. (Os links simbólicos reais não são mais criados no www.gnu.org; em vez disso, são usadas as regras do mod_rewrite. Mas manteremos essa discussão falando sobre links simbólicos, já que é mais fácil entender isso.)
Ser um link simbólico significa que os links relativos da página vinculada podem ser interrompidos quando o link simbólico pula para um diretório diferente.
Arquivos especiais, chamados .symlinks
, ao fazer commit para a
árvore CVS, são interpretados como especificações para construir links
simbólicos. Cada especificação de link simbólico do arquivo .symlinks é
honrada, ou seja, o link simbólico é criado se ainda não existir. Se um link
simbólico for encontrado no diretório e não estiver listado no arquivo
.symlinks, ele será removido.
Os arquivos .symlinks obedecem ao formato ln -s
, conforme
descrito abaixo:
Aqui está um exemplo de um arquivo .symlinks:
# Cria um link chamado l.html para um alvo t.html. # É estritamente equivalente a ln -s t.html l.html: t.html l.html
Em cada linha, o primeiro nome de arquivo deve ser um nome de caminho
relativo para um arquivo existente. O segundo nome de arquivo não pode
conter nenhuma barra; é o nome do link simbólico a ser criado no diretório
atual. Por exemplo, se uma página chamada DIR.html
existir no
diretório /DIR
, e index.html
não existir,
/DIR/.symlinks
deve conter uma linha como esta:
DIR.html index.html
A analogia de ln -s
representa apenas parte da história. O
método atual realmente aproveita a flexibilidade da regravação de
URL. Assim, uma única entrada HTML no arquivo .symlinks define links para
todas as possíveis traduções que seguem nossas convenções de nomenclatura. Isso torna
impossível usar links simbólicos para redirecionar para e de arquivos HTML
cujos nomes se parecem com traduções, ou seja,
página.LL.html
ou
página.LL-CC.html
, onde LL e CC são códigos de duas
letras. Quando você precisar desses redirecionamentos, use o mecanismo htaccess.
Hoje em dia, o tratamento de .symlinks acontece em www.gnu.org por meio de uma tarefa de cron que é executada duas vezes por hora. Os webmasters não têm acesso a ele.
Para os navegadores, os links simbólicos na seção anterior são
indistinguíveis do arquivo real. Você pode querer um redirecionamento real
em alguns casos. Você pode fazer isso no arquivo de controle de nível
superior .htaccess
, ou usando algo parecido com isto como o
arquivo a ser redirecionado:
<meta http-equiv=“refresh” content=“0;
url=http://www.gnu.org/alvo”>
Uma descrição de scripts e software usados no www.gnu.org está disponível. Por favor, leia-a antes de escrever qualquer script, e também atualize-a conforme necessário, se você tiver acesso de escrita a www.
Os administradores de sistema do GNU mudam de tempos em tempos. Por favor, envie um e-mail para a lista de sysadmin <sysadmin@gnu.org> em vez de uma pessoa específica, a menos que você tenha uma razão específica para isso.
/gnumaint
no grupo Savannah
womb
(aqueles arquivos são usados por administradores mantenedores do GNU para
atualizar os arquivos /*/allgnupkgs.html
no www);O w3 é um navegador da web para o GNU Emacs, semelhante ao Internet Explorer. Ele pode rodar em todas as plataformas em que o GNU Emacs roda, incluindo GNU/Linux, sistemas Unix proprietários e Windows.
O GNOME faz parte do Projeto GNU e é um software livre (às vezes chamado de software de código aberto).
Assim como na nossa página de links, a FSF não é responsável pelo conteúdo de outros sites, nem pela atualização de suas informações.