no way to compare when less than two revisions
Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
— | orsoftdoku:popisdoku [2017/01/20 11:52] (aktuální) – vytvořeno - upraveno mimo DokuWiki 127.0.0.1 | ||
---|---|---|---|
Řádek 1: | Řádek 1: | ||
+ | ====== Orsoft Doku - používání ====== | ||
+ | |||
+ | |||
+ | **Orsoft Doku** je systém nápovědy a dokumentace pro IS Orsoft Open. | ||
+ | |||
+ | |||
+ | Jednotlivé články (help stránky) jsou textové soubory, formátované pomocí Wiki syntaxe. Popis formátování je v samostatném článku. | ||
+ | |||
+ | |||
+ | Články jsou organizovány do tzv. jmenných prostorů (namespaces). Toto jsou vlastně adresáře na webovském serveru Orsoft Doku. Hierarchie těchto adresářů tvoří adresářovou strukturu serveru. V současné době je vývojový server Orsoft Doku umístěn na serveru **ortexts2**, | ||
+ | |||
+ | |||
+ | Základním členěním jsou: | ||
+ | |||
+ | |||
+ | * **media** | ||
+ | * **pages** | ||
+ | Ostatní adresáře jsou pracovní pro vlastní server, tedy v nich neprobíhají **žádné úpravy**. | ||
+ | |||
+ | |||
+ | ===== Hirarchie článků ===== | ||
+ | |||
+ | |||
+ | Články jsou organizovány v adresářích dle svého logického umístění: | ||
+ | |||
+ | |||
+ | * **orsoft** | ||
+ | * **orsoftdoku** | ||
+ | * **orsoftopen** | ||
+ | * **orsoftweb** | ||
+ | * **orsoftimpl** | ||
+ | * **orsoftmodel** | ||
+ | Výchozím adresářem pro Orsoft Open je tedy **orsoftopen**. | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | Adresář // | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | V adresáři // | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | Tím je daná i logická vazba mezi vývojem v Javě (balíček) a dokumentací (článek). Jednotlivé články lze použít zaroveň jako nápovědu pro Orsoft Open - toto je zajištěno strukturou balíčku, názvem panelů a názvem článků. | ||
+ | |||
+ | |||
+ | Př. // | ||
+ | |||
+ | |||
+ | Vlastní propojení a příslušné volání nápovědy je zajištěno jádrem Orsoft Open. | ||
+ | |||
+ | |||
+ | ===== Logické řazení článků ===== | ||
+ | |||
+ | |||
+ | Obecná hierarchie a zařazení článků pro jednotlivé podsystémy Orsoft Open by mělo ctít následující strukturu: | ||
+ | |||
+ | |||
+ | Úvod - něco jako „jednolist“, | ||
+ | |||
+ | |||
+ | * co podsystém umí | ||
+ | * pro koho je určen | ||
+ | * jaké má místo v systému | ||
+ | * jakou má strukturu | ||
+ | |||
+ | |||
+ | Popis funkcí | ||
+ | |||
+ | |||
+ | * logicky uspořádané a popsané funkce podsystému včetně nápověd pro jednotlivé prvky (menu, pořizovací obrazovky) | ||
+ | * případné odkazy na dokumentaci Základní části nebo na jiné kapitoly vlastní dokumentace | ||
+ | |||
+ | |||
+ | Parametry | ||
+ | |||
+ | |||
+ | * logický popis možných parametrů včetně nápověd pro jednotlivé prvky | ||
+ | |||
+ | |||
+ | Implementace (vytváří a udržují konzultanti) | ||
+ | |||
+ | |||
+ | * Standardní nastavení | ||
+ | * Postup | ||
+ | * Archivace dat | ||
+ | |||
+ | |||
+ | **Seznam změn** | ||
+ | |||
+ | * Pro každou roční verzi se udržuje jeden seznam změn, který obsahuje popis kompletní verze (kompletní roční distribuce) a seznamy změn k důležitým aktualizacím. Seznamy změn k aktualizacím se v dokumentu umísťují nahoru (nejnovější nejvýše). Seznam změn pro podsystém se vytváří pouze tehdy, došlo-li v něm k významným změnám (tj. nikoliv každý týden, kdy se automaticky generují a zveřejňují knihovny distribuční verze) | ||
+ | * Aktualizace a seznamy změn se rozlišují datem vydání, struktura názvu seznamu změn je tato: | ||
+ | * //Seznam změn - [podsystém] - verze [verze] - poslední změna [**datum**]// | ||
+ | * např.: Seznam změn - Personalistika - verze 16.1 - poslední změna **9.3.2016** | ||
+ | * pokud je do seznamu zapsána aktualizace s novým datem, je potřeba toto datum promítnout také do názvu seznamu změn. Uživatel se potom může orientovat podle data v názvu, a nemusí seznam změn vůbec otevírat, když v něm dle data není nic nového. | ||
+ | * Formát nadpisů AKTUALIZACE a KOMPLETNÍ VERZE je druhý největší nadpis, např. =====AKTUALIZACE - 9.3.2016=====, | ||
+ | * Aktualizovaný seznam změn se dostane na web ORTEXu spolu s celou DokuWiki automaticky každý týden. Je tedy k dispozici zákazníkovi, | ||
+ | * Příklad pojmenování seznamů změn: | ||
+ | {{: | ||
+ | * Příklad obsahu seznamu změn: | ||
+ | {{: | ||
+ | | ||
+ | |||
+ | ===== Příklad řazení článků pro Základní část ===== | ||
+ | |||
+ | |||
+ | Úvod | ||
+ | |||
+ | |||
+ | * Něco jako jednolist | ||
+ | |||
+ | |||
+ | Základy obsluhy | ||
+ | |||
+ | |||
+ | * popis ovládání (klávesy, obsluha, tisky, nápovědy, exporty…) | ||
+ | * popis společných principů (prvků) | ||
+ | |||
+ | |||
+ | Administrace | ||
+ | |||
+ | |||
+ | * Oprávnění | ||
+ | * Operátorské činnosti | ||
+ | * Instalace | ||
+ | * Aktualizace | ||
+ | * … | ||
+ | |||
+ | |||
+ | Kmenová data | ||
+ | |||
+ | |||
+ | Parametry | ||
+ | |||
+ | |||
+ | Implementace | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | Seznam změn | ||
+ | |||
+ | |||
+ | |||
+ | ===== Oddíl Datový model ===== | ||
+ | |||
+ | |||
+ | Datový model - je udržován samostatně, | ||
+ | |||
+ | |||
+ | * Odkaz na datový model | ||
+ | * Případná rozhraní | ||
+ | |||
+ | |||
+ | ===== Oddíl Implementace ===== | ||
+ | |||
+ | |||
+ | Implementace každého podsystému je vytvářena a udržována konzultanty. | ||
+ | |||
+ | |||
+ | Skládá se z : | ||
+ | |||
+ | |||
+ | Implementace | ||
+ | |||
+ | |||
+ | * Standardní nastavení | ||
+ | * Postup | ||
+ | * Archivace dat | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | ===== Příklad postupu tvorby článku ===== | ||
+ | |||
+ | |||
+ | Zde je popsán jeden ze způsobů jak vytvářet nový článek. | ||
+ | |||
+ | |||
+ | === A. založení nového článku === | ||
+ | |||
+ | == A1. založení nového článku z Orsoft Open == | ||
+ | 1. V Orsoft Open překontrolujeme, | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | 2. Připravíme příslušné obrázky | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | a uložíme do příslušného adresáře // | ||
+ | |||
+ | |||
+ | 3. Použijeme ikonu {{ : | ||
+ | Jestliže stránka nápovědy existuje nabídne se tato k aktualizaci, | ||
+ | |||
+ | |||
+ | == A2. " | ||
+ | 1. Založíme soubor txt do adresáře dle zvolené hierarchie | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | Zde pro podsystém ZIS, úvodní stránku // | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | 2. Připravíme příslušné obrázky | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | a uložíme do příslušného adresáře // | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | === B. založení volby v menu === | ||
+ | |||
+ | **POZOR - Bohužel, pro založení volby v menu, nebo pro editaci menu nelze použít FCK Edit, dochází z celkovému poškození struktury menu. | ||
+ | Pro editaci menu je třeba DW Edit** | ||
+ | |||
+ | 1. Použijeme volbu k editaci menu. | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | 2. Do příslušné hierarchie založíme nový článek s odkazem: | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | 3. Přejdeme do založené volby | ||
+ | |||
+ | |||
+ | a dáme //Upravit stránku// | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | provedeme editaci - úpravy textu, vložení obrázků, formátování | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | 4. Uložíme | ||
+ | |||
+ | |||
+ | volbou (tlačítkem) // | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | {{ http:// | ||