Documentação do Tumblr em Português (Parte 1)

Post escrito por Yeltsin Lima

Nota do Tradutor: Todo o texto foi traduzido por mim (Yeltsin Lima). Porém, todo o texto abaixo ainda está sobre os direitos do Tumblr, Inc. Apesar do blog estar sob licença Creative Commons. Na segunda parte dessa publicação, vou colar a resposta do e-mail que enviei ao Tumblr.

O Tumblr permite a customização completa da aparência do seu blog, editando o código HTML. Isso é recomendado apenas para usuários que se sintam confortáveis editando códigos HTML. Se você não é, existem centenas de ótimos temas para escolha em nosso “Theme Garden“.

Assim que você criar o tema, que você se sinta orgulhos, envie ele para o Theme Garden para compartilhar com todos que usam o Tumblr.

Introdução

Para iniciar, clique no botão “Customizar” no seu Dashboard (existe uma tradução para isso. Mas, não acho Painel de Controles, um nome bem interessante para isso. Nem Painel). Clique na aba “Tema” e clique em “Use código HTML customizado“. Isso vai trazer uma caixa de texto com o código HTML do seu tema atual.

O Tumblr possui dois tipos de operadores especiais usados para renderizar conteúdo HTML. Variáveis são usadas para inserir dados dinâmicos como o título do seu blog ou a descrição.

<html>
    <head>
        <title>{Title}</title>
    </head>
    <body>
        ...
    </body>
</html>

Blocos são usados tanto para renderizar um bloco de HTML para um conjunto de dados (como seus artigos), ou para renderizar condicionalmente blocos de HTML (como o link de “Página Anterior”)

<html>
    <body>
        <ol id="posts">
            {block:Posts}
                <li> ... </li>
            {/block:Posts}
        </ol>
    </body>
</html>

Abaixo, um exemplo de um código completo de um tema.

<html>
    <head>
        <title>{Title}</title>
        <link rel="shortcut icon" href="{Favicon}">
        <link rel="alternate" type="application/rss+xml" href="{RSS}">
        {block:Description}
            <meta name="description" content="{MetaDescription}" />
        {/block:Description}
    </head>
    <body>
        <h1>{Title}</h1>

        {block:Description}
            <p id="description">{Description}</p>
        {/block:Description}

        <ol id="posts">
            {block:Posts}
                {block:Text}
                    <li>
                        {block:Title}
                            <h3><a href="{Permalink}">{Title}</a></h3>
                        {/block:Title}

                        {Body}
                    </li>
                {/block:Text}

                {block:Photo}
                    <li>
                        <img src="{PhotoURL-500}" alt="{PhotoAlt}"/>

                        {block:Caption}
                            <div>{Caption}</div>
                        {/block:Caption}
                    </li>
                {/block:Photo}

                {block:Photoset}
                    <li>
                        {Photoset-500}

                        {block:Caption}
                            <div>{Caption}</div>
                        {/block:Caption}
                    </li>
                {/block:Photoset}

                {block:Quote}
                    <li>
                        "{Quote}"

                        {block:Source}
                            <div>{Source}</div>
                        {/block:Source}
                    </li>
                {/block:Quote}

                {block:Link}
                    <li>
                        <a href="{URL}" {Target}>{Name}</a>

                        {block:Description}
                            <div>{Description}</div>
                        {/block:Description}
                    </li>
                {/block:Link}

                {block:Chat}
                    <li>
                        {block:Title}
                            <h3><a href="{Permalink}">{Title}</a></h3>
                        {/block:Title}

                        <ul>
                            {block:Lines}
                                <livariable" style="outline-color: initial;
                                outline-style: none; outline-width: 0px; ">
                                {Alt} user_{UserNumber}">
                                    {block:Label}
                                        <span>{Label}</span>
                                    {/block:Label}

                                    {Line}
                                </li>
                            {/block:Lines}
                        </ul>
                    </li>
                {/block:Chat}

                {block:Video}
                    <li>
                        {Video-500}

                        {block:Caption}
                            <div>{Caption}</div>
                        {/block:Caption}
                    </li>
                {/block:Video}

                {block:Audio}
                    <li>
                        {AudioPlayerBlack}

                        {block:Caption}
                            <div>{Caption}</div>
                        {/block:Caption}
                    </li>
                {/block:Audio}
            {/block:Posts}
        </ol>

        <p id="footer">
            {block:PreviousPage}
                <a href="{PreviousPage}">&#171; Previous</a>
            {/block:PreviousPage}

            {block:NextPage}
                <a href="{NextPage}">Next &#187;</a>
            {/block:NextPage}

            <a href="/archive">Archive</a>
        </p>
    </body>
</html>

Variáveis Básicas

Nota: Como a estruturação de tabelas é interessante mas, não fica bem formatada no atual tema (preciso modificar o child theme e incluir as novas folhas de estilo para tabela, ou seja, vai demorar), resolvi colocar em listas. E caso os leitores prefiram a versão formatada, disponibilizarei no último artigo desta série, um arquivo em PDF com a documentação traduzida.

  • {Title} – O título HTML-seguro do seu blog
  • {Description} – A descrição do seu blog (pode incluir HTML)
  • {MetaDescription} – A tag HTML-safe da descrição do seu blog, utilizada como meta tag
  • {RSS} – O feed RSS do seu blog
  • {Favicon} – A URL do favicon do seu blog
  • {CustomCSS} – Qualquer código CSS customizado adicionado usando a ferramenta “Customizar tema”
  • {block:PermalinkPage}{/block:PermalinkPage} – Renderizada nas páginas dos links permanentes dos artigos (Útil para adicionar widgets de comentário).
  • {block:IndexPage}{/block:IndexPage} – Renderizada na página inicial (dos artigos)
  • {block:PostTitle}{PostTitle}{/block:PostTitle} – Renderizada nas páginas de links permanentes. (Útil para exibir o título do atual artigo no título das páginas). Exemplo:
    <title>{Title}{block:PostTitle} – {PostTitle}{/block:PostTitle}</title>
  • {block:PostSummary} {PostSummary} {/block:PostSummary} – Idêntico ao {PostTitle}, mas vai gerar automaticamente um resumo se o título não existir.
  • {PortraitURL-16} – URL da foto “retrato” do seu blog. 16-pixels por 16-pixels.
  • {PortraitURL-24} - URL da foto “retrato” do seu blog. 24-pixels por 24-pixels.
  • {PortraitURL-30} – URL da foto “retrato” do seu blog. 30-pixels por 30-pixels.
  • {PortraitURL-40} – URL da foto “retrato” do seu blog. 40-pixels por 40-pixels.
  • {PortraitURL-48} – URL da foto “retrato” do seu blog. 48-pixels por 48-pixels.
  • {PortraitURL-64} – URL da foto “retrato” do seu blog. 64-pixels por 64-pixels.
  • {PortraitURL-96} – URL da foto “retrato” do seu blog. 96-pixels por 96-pixels.
  • {PortraitURL-128} – URL da foto “retrato” do seu blog. 128-pixels por 128-pixels.

Navegação

  • {block:Pagination} {/block:Pagination} – Renderizada se existir uma página “anterior” ou “próxima”.
  • {block:PreviousPage} {/block:PreviousPage} – Renderizada se existir uma página “anterior” para navegar para (página anterior significa Novos artigos).
  • {block:NextPage} {/block:NextPage} – Renderizada se existir uma página “posterior” para navegar para. (página posterior significa artigos Antigos).
  • {PreviousPage} – URL para a página antiga (novos artigos).
  • {NextPage} – URL para a página posterior (artigos antigos).
  • {CurrentPage} – Número da página atual
  • {TotalPages} – Número total de páginas
  • {block:SubmissionsEnabled} {/block:SubmissionsEnabled} – Renderiza se as contribuições estiverem ativadas
  • {SubmitLabel} – Para customizar o texto do link de Envio. (Exemplo: “Enviar”).
  • {block:AskEnabled} {/block:AskEnabled} – Renderiza se o formulário de pergunta estiver ativado
  • {AskLabel} – Para customizar o texto do link de Pergunta. (Exemplo: “Faça-me uma pergunta”).

Pular para a navegação

  • {block:JumpPagination length=”5″} {/block:JumpPagination} – Renderizada para cada página maior do que a atual menos metade do caminho até a página atual mais metade do caminho.
  • {block:CurrentPage} {/block:CurrentPage} – Renderizada quando a página que for “pulada para” é a atual.
  • {block:JumpPage} {/block:JumpPage} – Renderizada quando a página que for “pulada para” não é a atual.
  • {PageNumber} – Número da página para a página que for “pulada para”.
  • {URL} – URL da página que for “pulada para”.

Exemplo:

<html>
    <body>
        ...

        {block:Pagination}
            {block:PreviousPage}
                <a href="{PreviousPage}">Previous</a>
            {/block:PreviousPage}

            {block:JumpPagination length="5"}
                {block:CurrentPage}
                    <span>{PageNumber}</span>
                {/block:CurrentPage}

                {block:JumpPage}
                    <a href="{URL}">{PageNumber}</a>
                {/block:JumpPage}
            {/block:JumpPagination}

            {block:NextPage}
                <a href="{NextPage}">Next</a>
            {/block:NextPage}
        {/block:Pagination}
    </body>
</html>

 Documentação do Tumblr em Português (Parte 1)

Artigo por Yeltsin Lima

Curso o primeiro período de Publicidade & Propaganda na Faculdade Integradas Barros Melo (AESO), sou colaborador do Meio Bit e fundador do DicasWP.

1 Comentário
  • Bruno Gall disse:

    Excelente, estava atrás disso!

  • Deixe um comentário

    Conecte-se com uma das redes abaixo:

    Você pode fazer o Login ou se registrar para ganhar pontos. :-)

    300x250cirlclesnewptpng
    '
    • Premium Themes
    • Premium resources for designers

    Selo peixe Grande 2011

    Junte-se a galera!

    Tweets Recentes

    Enquete

    O que você achou do novo visual?

    Ver Resultados

    Loading ... Loading ...