Tellico/pl: Difference between revisions

From KDE Wiki Sandbox
(Created page with "== Więcej informacji == * Strona '''Tellico''': http://tellico-project.org * Dokumentacja '''Tellico''' [http://docs.kde.org/development/en/extragear-office/tellico/index.htm...")
(Updating to match new version of source page)
 
(12 intermediate revisions by 2 users not shown)
Line 25: Line 25:
Dla Ubuntu/Kubuntu nieoficjalne pakiety są dostępne [https://launchpad.net/~dominik-stadler/ tutaj].
Dla Ubuntu/Kubuntu nieoficjalne pakiety są dostępne [https://launchpad.net/~dominik-stadler/ tutaj].


<span class="mw-translate-fuzzy">
== Więcej informacji ==
== Więcej informacji ==
* Strona '''Tellico''': http://tellico-project.org
* Strona '''Tellico''': http://tellico-project.org
* Dokumentacja '''Tellico''' [http://docs.kde.org/development/en/extragear-office/tellico/index.html jest dostępna online].
* 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].
* 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