Dodajanje pomožnih datotek pomoči

From The Document Foundation Wiki
Jump to: navigation, search

Kaj je pomožna datoteka?

Collateral files

LibreOffice new Help system enabled the already existing <object> element that allows to open objects in the HTML help page. Objects can be embedded or external videos, audio, and also files with specific MIME types.

From LibreOffice 6.1 and beyond, the help system now has support for collateral files to help user in understanding the textual description of the current page.

Im-jabber.svg

Note:
Collateral files are not available in the offline help package.

Kaj pomožna datoteka NI

The collateral files are not intended to replace or turn obsolete the textual description of a feature. For example, a supporting file on Calc's trigonometric functions will not replace the help page on trigonometric function. Nor a collateral file on Pivot tables will do.

The collateral file also should not be alternative of a encyclopedic text on a feature. There is no point to use Calculus textbook to explain the COS trigonometric function. The Help system expect user to source its knowledge in appropriate textbooks and supply simple examples for quick remind or working function syntax.

How do I submit a new collateral file to LibreOffice Help?

Your help is welcome, of course. If you want to supply a new collateral help file to a specific help page, please open a ticket in our bugzilla system and attach your file. Here is the process:

  1. Make sure you have all the credentials to open a bug in our bugzilla. If not, please follow the instructions in this wiki page.
  2. Open a new bug with the following settings:
  • Component: Documentation
  • Version: unspecified
  • Summary: Enter a summary. For example, [COLLATERAL_FILES] File for help page on feature XYZ
  • Description: describe the purpose of the collateral file and give as much details as you can. If you know the help page where the file belongs, then it is even better. You can supply the help page by indicating the link of the page in the help online. For example, [https://help.libreoffice.org/6.1/en-US/text/scalc/01/04060101.html]
  1. Attachments: Attach your file to the bugzilla
  2. IMPORTANT: enter 117613 to the Blocks: field (this will link your contribution to the metabug).
  3. Submit your bug report.

To je vse.

Pravila za izdelavo pomožnih datotek

"KISS" : Keep It Simple, Stupid.

Well, sort of.

The Help system must help the user. Sounds obvious but there is no point to insert a complicated collateral file when the intention is to explain simple concept. For example, a Chart collateral file must not have a data series with hundreds of data points, nor must display fancy coloring of the chart elements.

Try to create a file with the minimal text inside. Sometimes, it will not be possible, but some trick will reduce the workload for translation:

  1. Keep file small
  2. Unless otherwise justified, always provide Open Document Formats (ISO-IEC 26300), such as *.odt, *.ods, *.odp, *.odg, *.odf, *.odb.
  3. In Calc functions, you can use the =FORMULA(<ref>) to get the localized name of the function.
  4. Also in Calc, if a function belongs to a category of functions, consider one single file with many examples (see 1 above). For example, database functions DSUM, DCOUNT, DMAX, etc... can belong to one collateral file only.
  5. Do not create files with macros. Even with safe macros, the security warnings can bring troubles to the user.
  6. Do not use complicated styling, unless absolutely necessary
  7. Avoid files with external references, external links (that may create issues with corporate firewalls, etc...).
  8. There is no point in providing many files on the same subject. Improve the existing one.

Vsebine za dodajanje pomožnih datotek

Calc

  • Funkcije zbirke podatkov DSUM, DMAX, DCOUNT, itn. Strani pomoči že imajo primere v besedilu, ki jih lahko prenesemo v pomožno datoteko.
  • Statistične funkcije (ponudite majhen vendar značilen vzorec podatkov z uporabo statističnih funkcij)
  • Finančne funkcije
  • Iskanje cilja
  • Reševalec
  • Več operacij
  • Scenariji
  • (drugo)

Datoteke programa Writer

  • Kazala
  • Kazalo vsebine
  • Uporaba sloga strani (ležeče/pokončno)
  • Slogi
  • (drugo)

Impress

  • Prehodi med prosojnicami
  • Animiranje predmetov
  • (drugo)

Draw

  • Plasti
  • Predmeti
  • Dimenzijske črte
  • Osvetljevanje predmetov
  • Porazdelitev
  • (drugo)

Base

  • Vzorec zbirke podatkov
  • (drugo)

Math

  • Primeri enačb
  • (drugo)

Prevajanje

V nekaterih državah mora biti besedilo pomoči in vse komponente programja v (enem od) (uradnem) jeziku države. To zahteva prevajanje pomožne datoteke, ko je to mogoče.

Privzeti in rezervni jezik je angleški (en-US).

Im-jabber.svg

Note:
Izvorne datoteke se nahajajo na spodaj navedenih karticah.

Calc

Writer

Impress

Draw

Base

Math

Uploading files to master branch

Upload of files will be carried trough gerrit.