Tellico/Templates: Difference between revisions
No edit summary |
(Marked this version for translation) |
||
| Line 2: | Line 2: | ||
<translate> | <translate> | ||
<!--T:1--> | |||
[[Tellico|Tellico]] uses XSL templates for formatting the information shown in the main window, as well as for creating reports, exporting HTML, and printing. | [[Tellico|Tellico]] uses XSL templates for formatting the information shown in the main window, as well as for creating reports, exporting HTML, and printing. | ||
<!--T:2--> | |||
'''Tellico''' data is passed to the template in XML format, and the template converts that data to HTML for display. The templates can make full use of both CSS and Javascript, and can reference images or objects locally or elsewhere on the Internet. | '''Tellico''' data is passed to the template in XML format, and the template converts that data to HTML for display. The templates can make full use of both CSS and Javascript, and can reference images or objects locally or elsewhere on the Internet. | ||
<!--T:3--> | |||
User-contributed templates may be downloaded from [http://kde-files.org/index.php?xcontentmode=676 KDE-Files.org]. | User-contributed templates may be downloaded from [http://kde-files.org/index.php?xcontentmode=676 KDE-Files.org]. | ||
<!--T:4--> | |||
All templates should be installed in the local KDE application directory. The specific path may be found by adding <code>/tellico/</code> to the output from the command: | All templates should be installed in the local KDE application directory. The specific path may be found by adding <code>/tellico/</code> to the output from the command: | ||
{{Input|1=kde4-config --path data}} | {{Input|1=kde4-config --path data}} | ||
| Line 13: | Line 17: | ||
{{Output|1=$HOME/.kde/share/apps/tellico/}} | {{Output|1=$HOME/.kde/share/apps/tellico/}} | ||
== Entry Templates == | == Entry Templates == <!--T:5--> | ||
<!--T:6--> | |||
''Entry templates'' are used in the main window for showing the information for a single entry (book, album, etc.). The screenshot below is the [http://kde-files.org/content/show.php/Berean+Curves?content=40894 Berean Curves] template. | ''Entry templates'' are used in the main window for showing the information for a single entry (book, album, etc.). The screenshot below is the [http://kde-files.org/content/show.php/Berean+Curves?content=40894 Berean Curves] template. | ||
<!--T:7--> | |||
[[Image:TellicoBerea.png]] | [[Image:TellicoBerea.png]] | ||
<!--T:8--> | |||
The directory for installing entry templates is the application path, mentioned earlier, followed by ''/entry-templates/''. For example, most users would install entry templates in | The directory for installing entry templates is the application path, mentioned earlier, followed by ''/entry-templates/''. For example, most users would install entry templates in | ||
{{Input|1=$HOME/.kde/share/apps/tellico/entry-templates/}} | {{Input|1=$HOME/.kde/share/apps/tellico/entry-templates/}} | ||
<!--T:9--> | |||
After installing a new template, open the <menuchoie>Tellico Settings</menuchoice> dialog to the <menuchoice>Templates</menuchoice> page and select the new template. Templates can also be previewed there. | After installing a new template, open the <menuchoie>Tellico Settings</menuchoice> dialog to the <menuchoice>Templates</menuchoice> page and select the new template. Templates can also be previewed there. | ||
<!--T:10--> | |||
Entry templates can also be installed or downloaded directly from within [[Tellico|Tellico]] from the same Settings dialog. | Entry templates can also be installed or downloaded directly from within [[Tellico|Tellico]] from the same Settings dialog. | ||
== Report Templates == | == Report Templates == <!--T:11--> | ||
<!--T:12--> | |||
Report Templates process the information for the complete collection. Some templates will show only titles, images, or collection statistics. | Report Templates process the information for the complete collection. Some templates will show only titles, images, or collection statistics. | ||
<!--T:13--> | |||
The directory for installing report templates is the application path, mentioned earlier, followed by <code>/report-templates/</code>. For example, most users would install templates in | The directory for installing report templates is the application path, mentioned earlier, followed by <code>/report-templates/</code>. For example, most users would install templates in | ||
{{Input|1=$HOME/.kde/share/apps/tellico/report-templates/}} | {{Input|1=$HOME/.kde/share/apps/tellico/report-templates/}} | ||
<!--T:14--> | |||
After installing a new template, open the Report Dialog. The new template should be available there. | After installing a new template, open the Report Dialog. The new template should be available there. | ||
<!--T:15--> | |||
[[Category:Office]] | [[Category:Office]] | ||
[[Category:Home and Hobby]] | [[Category:Home and Hobby]] | ||
</translate> | </translate> | ||
Revision as of 14:12, 20 July 2011
Tellico uses XSL templates for formatting the information shown in the main window, as well as for creating reports, exporting HTML, and printing.
Tellico data is passed to the template in XML format, and the template converts that data to HTML for display. The templates can make full use of both CSS and Javascript, and can reference images or objects locally or elsewhere on the Internet.
User-contributed templates may be downloaded from KDE-Files.org.
All templates should be installed in the local KDE application directory. The specific path may be found by adding /tellico/ to the output from the command:
kde4-config --path data
The location is likely to be
$HOME/.kde/share/apps/tellico/
Entry Templates
Entry templates are used in the main window for showing the information for a single entry (book, album, etc.). The screenshot below is the Berean Curves template.
The directory for installing entry templates is the application path, mentioned earlier, followed by /entry-templates/. For example, most users would install entry templates in
$HOME/.kde/share/apps/tellico/entry-templates/
After installing a new template, open the <menuchoie>Tellico Settings</menuchoice> dialog to the page and select the new template. Templates can also be previewed there.
Entry templates can also be installed or downloaded directly from within Tellico from the same Settings dialog.
Report Templates
Report Templates process the information for the complete collection. Some templates will show only titles, images, or collection statistics.
The directory for installing report templates is the application path, mentioned earlier, followed by /report-templates/. For example, most users would install templates in
$HOME/.kde/share/apps/tellico/report-templates/
After installing a new template, open the Report Dialog. The new template should be available there.