Jump to content

Ferramenta de libro

From Meta, a Wikimedia project coordination wiki
This page is a translated version of the page Book tool and the translation is 91% complete.
Printed Wikipedia-books

Está previsto despregar a Colección de Extensión en máis proxectos WMF, o que permite a recopilación de artigos e a conversiónPDF. Esta páxina ten como obxectivo guíar ás comunidades para unha implementación exitosa de esta extensión. Polo tanto, se centra en Wikipedia nos seus diferentes idiomas. Para obter unha impresión de cómo funciona esta ferramenta, visite en.wikipedia.org e mire por "Print/export" > "crea un libro" na barra de navegación.

Introdución

Esta ferramenta deixa usuarios para organizar seleccións persoais de páxinas nun libro. Os libros poden ser:

  • Edita & estrutura utilizando capítulos
  • Persiste & carga, comparte
  • renderizar como PDF (exemplo)
  • Exportar como Documento de Texto ODF
  • ordered as a printed book with PediaPress (example)

Sexa esta versión da prensa Wikis Go Printable para máis información neste proxecto.

A extensión foi probada en *.wikibooks.org desde outubro de 2008 e está dispoñible na Wikipedia alemana desde o 27 de xaneiro de 2009. Outros despregues son scheduled.

Como Facer

Ti podes estar visitando esta páxina xa que se lle notificou que a súa Wikipedia despregará esta extensión en breve ( vexa todas) tenta ser unha guía.

Unha vez nestes básicos feitos hai algunhas melloras opcionais posibles:

Conceptos

libro
Normalmente refire a unha colección de páxinas (optionalmente con capítulos, título, subtitular), tamén pode referir a un PDF derivado, un libro imprimido ou un libro almacenado.
libro transitorio
Unha colección de artigos, lembrado na sesión de navegador actual. A lista de artigos dun libro transitorio pode ser visto en [[Special:Book]].
libro almacenado
unha colección almacenada de artigos, persistindo nunha páxina wiki regular, calquera usuario de nome de espacio ([[User:Name/Books/Bookname]]) ou o nome de espacio global ([[Wikipedia:Books/Bookname]]). Os libros de almacenamento poden ser cargados. O libro transitorio entón é unha copia do libro de almacenamento.
páxina de libro
Normalmente se refire a [[Special:Book]] onde tódolos artigos dun libro transitorio é listado e o libro pode ser modificado, salvado, pedido, exportado. Pode tamén referirse a un libro de almacenamento.
(libro) portlet
"crear libro" caixa titulada no sidebar (encapsulados 'engadir/quitar artigo'-, 'Amosar libro (N artigos)'-, 'Cargar libro'-, 'quitar libro'-, 'libros de axuda'-ligazóns).
libro de axuda
O principal [[Help:Books]] páxina ligada desde portlet.
"offline Exportación", "exportación", "en impresión", "versión de impresión", ...
refire a unha exportación dun libro tampouco dixitalmente (PDF, ODF) ou fisicamente (libro imprimido).
"Suxestións", "páxinas Suxeridas"
Refire a unha característica que suxire páxinas que están relacionadas co conxunto actual de páxinas no libro.

Mudando a localización

"Tenta facerte ben cos conceptos." Por exemplo,"Libros de Mostras (19 páxinas)" pode ser malinterpretado como se o PDF tivera 19 páxinas aindaque se basará en 19 artigos e probablemente terá moitas máis páxinas nun PDF ou libro impreso. ¿A qué se refire libro claro se un acaba de cargar un libro almacenado que agora é tamén un libro transitorio?

If you need to change messages, either change them in translatewiki.net (ext-collection) (effective after the next software update) or change them for the wiki by visiting [[Special:Allmessages]] and filtering for "coll-*" to see all related messages. A quick look at the source may help to find the right message identifier if in doubt.

Nota: A metáfora "libro" funciona ben para a maioría dos wikis. Pero non en *.wikibooks.org onde choca co seu concepto de "libro". Se vostede altera traducións en translationwiki.net podería ser bon notificar tódolos proxectos (por exemplo, wikibook) usando o mesmo idioma.

The localization of messages used in generated PDFs can also be change in translatewiki.net (mwlibrl).

Control dobre con translatewiki.Neto para verificar tódalas mensaxes de sistema utilizaron nesta extensión é traducida para a vosa lingua.

As páxinas utilizadas por esta extensión

Lista de tódalas páxinas, categorías, modelos que terían que ser creado.

Páxinas

[[Special:Book?bookcmd=book_creator]] (non require creación)
Unha página de introducción especial (a páxina que se mostra cando un usuario fai clic en "Crear un libro") que permite habilitar o "creador de libros" e traslada unha breve páxina de axuda. O nome desta páxina de axuda se pode establecer en Por defecto ven sendo: Help:Books/creador de Libros de texto É dicir, unha subpáxina da páxina de axuda configurada a ligazón "Creador de libros de texto".
[[Special:Book]] (non require creación)
Unha páxina especial que deixa tódalas interaccións importantes en libros transitorios '.
[[Special:Book/rendering]] (non require creación)
A páxina de renderizado amosa un progreso mentras se xera o documento. Unha vez terminado amosa unha ligazón de descarga ao documento. Tambén podría mostrar un erro si falla o renderizado. Texto configurable coll-rendering_text, coll-rendering_article, coll-rendering_status, coll-rendering_page, coll-rendering_finished_text, coll-is_cached, coll-excluded_templates, coll-blacklisted_templates.
[[Special:Book/load_collection]] (non require creación)
Se utiliza para cargar "libros almacenados". Visible para o usuario só se se quere cargar un libro aínda que exista outro na sesión. Texto configurable en coll-load_overwrite_text, coll-overwrite, coll-append, coll-cancel
Axuda:Libros
Páxina de axuda principal (examplo) para esta ferramenta, ligada desde portlet. A súa ubicación pode configurarse no mensaxe do sistema coll-helppage
Tódalas plantillas a ligazóns desde esta páxina serán excluidas en forma impresa. Se recomenda non usar esta característica xa que é un enfoque centralizado e inflexible. O [[Category:Exclude in print]] (véxase máis abaixo). A ubicación se pode cambiar en coll-template_blacklist_title.

Categorías

[[Category:Wikipedia:Book tool]]
Adoitou almacenar toda a documentación e os modelos e páxinas relacionadas.
Categoría:Wikipedia:Libros
Categoría que rastrea tódolos "libros almacenados". Esta categoría é especial xa que tódalas páxinas incluidas poden ser cargadas como un libro por un "libro de carga"-vínculo que aparece no portlet se un visita unha páxina nesta categoría. Dito esto, os "libros almacenados" se engaden automáticamente no momento da creación, mentras que as páxinas que non sexan "libros almacenados" non deberían existir nesta categoría. Pode ser configurado por coll-bookscategory. Probablemente queiras cambiar este mensaxe a "Wikipedia:Books" (categoría "Libros" é o valor predeterminado).
[[Category:Exclude in print]]
Se usa para rastrexar tódalas plantillas que inxectan información inútil o que distrae nas exportaciones. (vexa below para máis motivación). Pode ser configurada por coll-exclusion_category_title.

Modelos

[[Template:Saved book]]
Este modelo (example) puede personalizarse para que a páxina dun "libro almacenado". Sexa máis atractiva e contenga algúns metadatos. A ubicación pode ser configurada por coll-savedbook_template.
[[Template:Hide in print]]
Este modelo (example) devolve tódolos recargos pasados no primeiro parámetro (read: does nothing). Se engades á [[Category:Exclude in print]] permite omitir selectivamente contidos en libros impresos ou PDFs. Moi práctico! Pode nomear esto como queira, pero non olvide engadilo á categoría e ligalo na axuda do experto. Nota: Esta plantilla recibiu unha rápida adopción e pronto foi unha das plantillas máis incluídas, polo que é posible que dexe protexela.
[[Template:Only in print]] e [[Template:PrintOnly in print]]
Este modelo (example) devolve non do recargo que foi pasado no primeiro parámetro, mentras que a correspondente [[Template:Only in print/Print]] (example) devolve a pasada marca. Vexa Axuda para expertos para máis sobre */Print-subpáxina usada para substituir modelos a imprimir. O prefixo que se utiliza para sustituir as plantillas impresas pode ser configurado por coll-print_template_prefix.

Configuración dunha fonte de licenza persoalizada

Algunhas comunidades poden querer engadir algúns texto extra á licenza no PDF. A licenza para ser incluída no PDF é configurable por MediaWiki:Coll-license_url a un URL que sinala ao wikitext en burto que estará acostumado a prestar a licenza. Por defecto en Wikimedia sitios públicos isto é posto en https://creativecommons.org/licenses/by-sa/3.0/.

Modelos para excluír en exportacións offline

Hai moitos modelos con contido que tería que ser excluído en versións de impresión. Hai polo menos tres tipos importantes:

Mensaxes de mantemento
Son inútiles e distraendo en offline exportacións como un non pode contribuír se está offline. Exemplos: Maintenance, Cleanup...
Mensaxes de advertencia & consellos
Son inútiles e distraen nas exportacións offline, xa que os usuarios se deron conta ao seleccionar o contido e elixiron engadilo de tódolos xeitos. Exemplos:

Fontes dos artigos, Disputes, Borrado, Xeral..

Contido navigacional
As ligazóns de navegación son inútiles e distraen nas exportacións. Exemplos: Compact TOC, Wikimedia proxectos irmáns...

Tales modelo terían que ser marcados coa clase CSS noprint.

É recomendado para identificar e engadir modelos relevantes a esta categoría temperá -antes do despregue, se é posible.

En Wikipedia alemá eramos capaces a rápido de identificar 130 modelos por ollar en categorías relacionadas. Listámoslles todo nunha páxina e utilizou un bot para atribuír a categoría. Só 14 modelos foron identificados que necesitaros para ser engadidos a man desde entón.

Pista: Algúns modelos serven coma modelos para outros. En tales casos debe ser suficiente para engadir este modelo (pai) á categoría; resultando na exclusión dunha clase enteira de modelos.

Comunicando a dispoñibilidade do creador de libro e libros imprimidos

É posíbel a transclude dunha páxina na páxina render do PDF que é visto por un usuario se preme en Descargar como PDF. Nestes usuarios de páxina (quen é evidentemente nalgúns offline desexando de estado) pode ser presentado ao creador de libros e a opción para conseguir libros imprimidos.

Vexa en:Help:Books/Rendering page info text para un exemplo desta páxina en en.wp e aquí vexa como asemella a páxina PDF renderizada.

Se a páxina existe na localización configurada nesta mensaxe de sistema Coll-rendering_page_info_text_article (exemplo en en.wp), aparecerá na páxina PDF de renderizado.

Organizadores de libros almacenados

Mentres moitos poden gozar con crear os seus libros propios, outros serán compracidos se poden directamente acceder a libros en temas relacionados.

A [[Wikipedia:Books]] páxina pode ser usada para promover a dispoñabilidade e accesibilidade de almacén de libros. Non hai moita experiencia neste tema aínda mais algunhas das ideas que xurdiron é listado no subseccións abaixo.

Promovendo a creación de libros

  • Proporcionar unha guía de como para crear "libros grandes":
    • como escoller un título adecuado;
    • como incluír un prefacio;
    • como escoller artigos;
    • número recomendado de artigos.
  • Desenvolve directrices para libros que son deixados de existir no global nome de espacios. Este podería requirir (exemplos):
    • número razoable de artigos incluídos (e.x. máis que 5 e menos que 200);
    • tendo un título significativo, subtitulo;
    • centrado nun tema;
    • calidade razoable de artigos incluídos (e.x. non disputado, cabichas, candidatos para borrado, etc.).
  • Coordinar temas.

Facendo os libros accesibles

  • Lista dalgúns libros do ano/do mes/da semana.
  • Etiqueta e presentar os libros excelentes.
  • Engade "Hai un libro sobre este tema" -caixa a artigos relacionados, categorías ou portais.
  • Ligue o traslade partes da estantería A-Z.

Estantería para libros

Os libros almacenados son seguidos na categoría [[Category:Wikipedia:Books]], pero esto se enche rápidamente (de. wp ten preto de 1.000 libros almacenados - a maioría no espazo de usuario - creados en 10 días). Ademáis, a vista de categorías permite non mostrar metadatos nin acceder a libros por tema. Sería posible ligar os libros ás categorías, pero esto podería desordear as categorías principais cos libros ou requerir/resultar nunha réplica do árbol de categorías nun espazo de nombres diferente.

hai un bot que automaticamente pode xerar un bookshelf o cal deixa para explorar libros por título (A-Z) ou palabras chave. Naturalmente un autolibro pode ser creado a man tamén. Visita o páxina autolibro para máis detalles relativos ao bot.

Preparando Páxina principal

As páxinas Principais ao lado dos portais son especiais, xa que a miudo utilizan un deseño web de múltiples columnas. Estas páxinas se ven realmente mal en PDFs renderizados (limitacións de ancho fixo das páxinas de deseño vertical). Pero esta é a páxina que casi todos os usuarios novos nesta ferramenta engaden primeiro ao seu libro.

Unha solución para evitar unha decepción prematura é preparar a páxina principal para que se vexa mellor en PDFs. Esto se pode facer utilizando o modo [[Hide in print]] template na que a páxina principal (en papel impreso) non ten ningunha taboa ou só consiste nunha columna. (FIXME:example)

Outro asunto é a visibilidade do portlet. Visitantes (non ti) a Wikipedia maioritariamente sinxelamente ignoran o sidebar. Podería axudar se hai algún aviso sobre esta característica nova e unha ligazón á páxina de axuda na páxina principal "Noticia sobre Wikipedia"-caixa (se está dispoñíbel) por un tempo limitado.

Informando Bugs, Recollendo a retroalimentación que Consegue Axuda

Dentro do wiki

Hai unha central feedback page ao meta (en inglés) axuda para recoller tódalas peticións de características, suxestións, informes de bugs, cuestións, etc. Wikipedias non en inglés pode querer xogar unha páxina similar (example) no seu wiki e definir algunha política cando e como os asuntos son traducidos e escalados á páxina de retroalimentación en meta.

seguidor de bugs

Uso de component "Colección" en bugzilla.

IRC

There is an IRC channel #pediapressconnect for anything related to the book tool.

Experiencias de desplegues anteriores

Wikipedia alemá

O que funcionou: A recepción da ferramenta foi maiormente positiva. Moitos libros almacenados foron creados nun corto periodo de tempo. Os medios de comunicación cubriron rápidamente este tema unha vez que houbo un comunicado de prensa do capítulo alemán.

What didn't work: It was planned to limit the new tool to logged-in users for the first week. Somehow this plan was not executed. As a result the feature was activated while documentation and localization were not really finished. For some users the portlet did not show up on some pages, probably due to caching. The MainPage was not print-version friendly (see above). Finally there was a slashdot effect after the popular german online news magazin Heise covered the story. The rendering server collapsed (load close to 300) instead of serving visitors.

Actualizacións

Actualiza - especialmente aqueles que requiren atención comunitaria - será anunciado aquí.

  • September 2014: statistics for sales have been updated till the end of 2013, at [1].
  • 3 Mar 2009 – PDF-server update & ColExt update
    • Important Change: The template substitution was changed from a prefix to a suffix */Print. The license to be included in the PDF is now configurable by setting MediaWiki:Coll-license_url
    • updated to mwlib release 0.9.11 (changelog)
    • updated to mwlib.rl release 0.9.8 (changelog)
    • Collection-Extension was updated to trunk (changelog)

mwlib + mwlib.rl are used for rendering documents, Collection-Extension implements the UI in Mediawiki