Tellico/pl: Difference between revisions

From KDE Wiki Sandbox
(Created page with "== Skąd wziąć Tellico ==")
(Updating to match new version of source page)
 
(17 intermediate revisions by 2 users not shown)
Line 17: Line 17:
== Skąd wziąć Tellico ==
== Skąd wziąć Tellico ==


'''Tellico''' is available for most Linux distributions, as well as the ports repository for the BSD variants. Please check your package manager to see if a package is available there.
'''Tellico''' jest dostępne dla wielu dystrybucji systemu Linux, a także posiada porty na systemy z rodziny BSD. Proszę sprawdzić menedżera pakietów, aby sprawdzić dostępność pakietu z Tellico.


Links to many of the packages are listed on the [http://tellico-project.org/download Tellico download page].
Linki do wielu pakietów jest podana na stronie [http://tellico-project.org/download pobierania Tellico].


[http://techbase.kde.org/Projects/Tellico/Compiling Compiling Tellico from the source code] requires installing several development packages.
[http://techbase.kde.org/Projects/Tellico/Compiling Kompilacja Tellico ze źródeł] wymaga instalacji kilku pakietów deweloperskich.


For Ubuntu/Kubuntu there are unofficial packages available in a [https://launchpad.net/~dominik-stadler/ PPA].
Dla Ubuntu/Kubuntu nieoficjalne pakiety są dostępne [https://launchpad.net/~dominik-stadler/ tutaj].


== More Information ==
<span class="mw-translate-fuzzy">
* The '''Tellico''' website is http://tellico-project.org
== Więcej informacji ==
* The '''Tellico''' user documentation is also [http://docs.kde.org/development/en/extragear-office/tellico/index.html available online].
* Strona '''Tellico''': http://tellico-project.org
* Questions and comments can be sent to the [http://tellico-project.org/mailing-list tellico-users mailing list].
* Dokumentacja '''Tellico''' [http://docs.kde.org/development/en/extragear-office/tellico/index.html jest dostępna online].
* Pytania i komentarze prosimy wysyłać [http://tellico-project.org/mailing-list tutaj].
</span>


= Bugs =
= Błędy =


Bug reports for '''Tellico''' use [http://bugs.kde.org KDE's bugzilla].
Błędy w '''Tellico''' możesz zgłaszać [http://bugs.kde.org KDE's tutaj].


[https://bugs.kde.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__all__&product=tellico Show all Tellico bugs].
[https://bugs.kde.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__all__&product=tellico Pokaż wszystkie błędy w Tellico].


= Default fields in use for XSLT processing =


If you want to extend '''Tellico''', you will certainly modify its XSLT processing files. Using default names for fields will makes your XSLT more compatible with others (for example "dewey" and "loc" are used for several data sources).
= XSLT processing =


The list is built at [[Tellico/DefaultFields]]
Tellico use XSL files for templates, reports, import, processing data source and export. XSL files apply on XML data.
The Tellico's DTD will give you the exact name of fields (because Tellico displays translated titles instead of names). Common places for this file are /usr/share/tellico/tellico.dtd or /usr/share/kde4/apps/tellico/tellico.dtd
Beware that Tellico use [http://xmlsoft.org/XSLT/index.html libxslt1.1] which implement [http://www.w3.org/TR/xpath XPath 1.0] functions only. Fortunately, you can use [http://www.exslt.org EXSLT] extensions.


[[Category:Office]]
== Basical XSLT for transforming export ==
 
First, do an XML export. The file will serve as a reference for testing.
Testing will be easier if you install an XSLT processor ([http://xmlsoft.org/XSLT/xsltproc2.html xsltproc] is available on every distribution).
Then write an xsl stylesheet. Here's a basic one :
 
{{Input|<syntaxhighlight lang="xml" line>
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns:tc="http://periapsis.org/tellico/"
                version="1.0">
<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
 
<xsl:template match="/">
  <xsl:apply-templates select="tc:tellico"/>
</xsl:template>
 
<xsl:template match="tc:tellico">
  <xsl:apply-templates select="tc:collection"/>
</xsl:template>
 
<!-- about your collection -->
<xsl:template match="tc:collection">
<books><!-- sample xml  output -->
<xsl:apply-templates select="tc:entry"/>
<books>
</xsl:template>
 
<!-- transform each entry -->
<xsl:template match="tc:entry">
<book><!-- sample xml  output -->
<title><xsl:value-of select="title"/></title>
<!-- other fields -->
</book>
</xsl:template>
 
</xsl:stylesheet>
</syntaxhighlight>}}
 
 
<span class="mw-translate-fuzzy">
= Domyślne pola  do użytku w przetwarzaniu XSLT =
</span>
 
<span class="mw-translate-fuzzy">
Jeżeli chcesz rozszerzyć '''Telico''' musisz edytować jego pliki przetwarzania XSLT. Używanie domyślnych nazw dla pól czyni Twoje XSLT bardziej kompatybilnym z innymi (dla przykładu nazwy "dewey" i "loc" są używane w kilku źródłach danych).
</span>
 
Lista tutaj: [[Tellico/DefaultFields]]
 
[[Category:Biuro/pl]]

Latest revision as of 15:37, 17 June 2015

Tellico jest aplikacją do katalogowania, dzięki niej możesz w prosty sposób śledzić swoje książki, filmy, muzykę, a nawet wina i wszystko inne. Prosty i intuicyjny interfejs pokazuje okładki, grupy i każdy inny detal jakiego potrzebujesz. Pobieraj informacje z wielu popularnych źródeł internetowych takich jak IMDB.com, Amazon.com, a także bibliotek.

Tellico jest częścią projektu KDE Extragear (moduł Office).

Pierwszy rzut oka

Główne okno programu Tellico wygląda tak:

Tellico może używać różnych szablonów, umożliwiających zmianę formatowania informacji o kolekcji.

Skąd wziąć Tellico

Tellico jest dostępne dla wielu dystrybucji systemu Linux, a także posiada porty na systemy z rodziny BSD. Proszę sprawdzić menedżera pakietów, aby sprawdzić dostępność pakietu z Tellico.

Linki do wielu pakietów jest podana na stronie pobierania Tellico.

Kompilacja Tellico ze źródeł wymaga instalacji kilku pakietów deweloperskich.

Dla Ubuntu/Kubuntu nieoficjalne pakiety są dostępne tutaj.

Więcej informacji

Błędy

Błędy w Tellico możesz zgłaszać KDE's tutaj.

Pokaż wszystkie błędy w Tellico.


XSLT processing

Tellico use XSL files for templates, reports, import, processing data source and export. XSL files apply on XML data. The Tellico's DTD will give you the exact name of fields (because Tellico displays translated titles instead of names). Common places for this file are /usr/share/tellico/tellico.dtd or /usr/share/kde4/apps/tellico/tellico.dtd Beware that Tellico use libxslt1.1 which implement XPath 1.0 functions only. Fortunately, you can use EXSLT extensions.

Basical XSLT for transforming export

First, do an XML export. The file will serve as a reference for testing. Testing will be easier if you install an XSLT processor (xsltproc is available on every distribution). Then write an xsl stylesheet. Here's a basic one :

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns:tc="http://periapsis.org/tellico/"
                version="1.0">
<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>

<xsl:template match="/">
  <xsl:apply-templates select="tc:tellico"/>
</xsl:template>

<xsl:template match="tc:tellico">
  <xsl:apply-templates select="tc:collection"/>
</xsl:template>

<!-- about your collection -->
<xsl:template match="tc:collection">
<books><!-- sample xml  output -->
<xsl:apply-templates select="tc:entry"/>
<books>
</xsl:template>

<!-- transform each entry -->
<xsl:template match="tc:entry">
<book><!-- sample xml  output -->
<title><xsl:value-of select="title"/></title>
<!-- other fields -->
</book>
</xsl:template>

</xsl:stylesheet>


Domyślne pola do użytku w przetwarzaniu XSLT

Jeżeli chcesz rozszerzyć Telico musisz edytować jego pliki przetwarzania XSLT. Używanie domyślnych nazw dla pól czyni Twoje XSLT bardziej kompatybilnym z innymi (dla przykładu nazwy "dewey" i "loc" są używane w kilku źródłach danych).

Lista tutaj: Tellico/DefaultFields