Komika vzniká, sledujeme-li tragédii a přivřeme jedno oko.
-- Ionesco |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
■ Diskuzní fórum
■ Pískoviště ■ Poslední změny ■ Registrace ■ Etický kodex ■ Nápověda ■ Administrace ■ Hlášení chyb © 1999-2008 HEAT JSPWiki v2.4.104
|
This is version 76.
It is not the current version, and thus it cannot be edited.
[Back to current version] [Restore this version] Nápověda PowerWikiObsahFormátování textu Formátování textuPsaní textuPro psaní obyčejného textu nepotřebujete znát nic zvláštního. Prostě a jednoduše jej napište do stránky. Jednotlivé řádky textu přímo za sebou jsou vysázené jako jeden odstavec. řádek jedna řádek dva řádek tři vysází: řádek jedna řádek dva řádek tři Pokud chceme, aby tyto řádky začínaly na nové řádce použijeme řádek jedna\\ řádek dva\\ řádek tři\\ vysází: řádek jedna Odstavce oddělujeme prázdnou řádkou. odstavec 1 odstavec 2 vysází: odstavec 1 odstavec 2 Styly písmaJe možné si vybrat z mnoha typů písma. Např.
Pokud to nestačí, použijte Cascading Style Sheets pro další možnosti. Zarovnávání odstavce%%center Text zarovnaný na střed %%
Text zarovnaný na střed
%%ltr Text zarovnaný doleva %%
Text zarovnaný doleva
%%rtl Text zarovnaný doprava %%
Text zarovnaný doprava
Vkládání obrázkůObrázky je možné do wiki stránek vkládat dvěma způsoby. Obě metody předpokládají, že obrázek je vložen do wiki jako souborová příloha. První způsob využívá standardní plugin Image. Příklad: [{Image src='Pics/test.png' caption='Testing Image' style='font-size: 120%; color: green;'}] Pro plugin Image můžeme použít následující parametry:
Druhý způsob využívá volitelné funkčnosti "inline" obrázků, kdy odkaz na soubor s příponami *.jpg, *.png, *.gif je přímo zobrazen jako obrázek. [Pics/test.png] Doporučení pro vkládané obrázkyObrázky použitelné jen v té konkrétní stánce přidávejte jako přiložené soubory k té konkrétní stránce, nebo vytvořte novou speciální stránku pro přiložené obrázky (užitečné např. když je obrázků mnoho). Společné obrázky vkládejte do určené stránky Pics NadpisyWiki umožňuje standardně tři úrovně nadpisů
Pro výrazné podbarvené nadpisy je k dispozici plugin ColorTitle, který se používá následujícím způsobem
Barvu pozadí je možné změnit pomocí parametru bgcolor.
SeznamyPro číslovaný a odrážkový seznam stačí příklad... Zdroják: * První položka * Druhá položka ** Vytvořte seznamy uvnitř seznamů použitím extra odsazením. ** Druhá odsazená položka. *** Dvojitě odsazená položka. * Třetí položka v hlavním seznamu. vysází:
# První položka # Druhá položka # Třetí položka v seznamu. ## První položka s odsazením ## Druhá položka s odsazením ### První položka s dvojitým odsazením ### Druhá položka s dvojitým odsazením ## Třetí položka s odsazením # Čtvrtá položka vysází:
TabulkyTabulky obyčejnéPomocí standardního JSPWiki značkovacího jazyka je možno poměrně jednoduše vytvořit jednoduché tabulky.
Tabulky můžeme oživit i pomocí stylů. ||%%(text-align:left)Left Heading%% ||%%(text-align:center)Center Heading%% ||%%(text-align:right)Right Heading%% |%%(text-align:left)Left Cell 11%% |%%(text-align:center)Center Cell 12%% |%%(text-align:right)Right Cell 13%% |%%(text-align:left)Left Cell 21%% |%%(text-align:center)Center Cell 22%% |%%(text-align:right)Right Cell 23%% |%%(text-align:left)left%% |%%(text-align:center)center%% |%%(text-align:right;color:red)combine alignment and color%% vysází
Tabulky složitéPro složitější nepravidelné tabulky je možno použít pluginu Table. Příklad dobře ilustruje, co a jak toho lze dosáhnout. [{Table |Nr |Aaa |< |Ccc |< |# |aaa |bbb |ccc |ddd |# |^ |bbb |^ |ddd }] vysází
Jiný příklad
Protože jde o plugin, a tabulka je parametrem tohoto pluginu, pokud chceme používat jiné pluginy (např. Image nebo nbsp, je potřeba je speciálně upravit pomocí znaku . [{Table | [{nbsp count='10'}] |Aaa | [{nbsp count='10'}] }] vysází
Parametry
Pokročilé formátování pomocí neviditelné tabulkyPokud tabulku obarvíme na barvu pozadí (většinou na bílo), můžeme své stránky formátovat v tabulkovém formátu. [{Table style='border-style: solid; border-color:#FFFFFF' dataStyle='border-style: solid; border-color:#FFFFFF' |X15APP | Aplikační počítačové prostředky |< |< |Rozsah výuky: |1+2 |Přednášející (garant): |Novák }]
Použití více sloupcůPro použití více sloupců jsou určené tři pluginy, které společně umožňují vícesloupcovou sazbu (stylem HTML tabulky). Na začátku vícesloupcové sazby je potřeba umístit následující plugin. [{BeginParagraphPlugin}] Po ukončení vícesloupcové sazby je potřeba ji ukončit použitím pluginu. [{EndParagraphPlugin}] Mezi těmito výše zmíněnými pluginy je každý sloupec uvozen následujícím pluginem, který má jako parametr šířku sloupce v procentech (100% je pro celou šířku stránky). Součet šířek všech sloupců by měl dávat 100. Mezi jednotlivé sloupce je občas užitečné pro oddělení textových sloupců vložit úzký prázdný sloupec (viz uvedený příklad). [{ColumnPlugin width='50'}] Příklad použití tří sloupcůZápis [{BeginParagraphPlugin}] [{ColumnPlugin width='30'}] !!!Sloupec jedna bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla [{ColumnPlugin width='3'}] [{ColumnPlugin width='30'}] !!!Sloupec dva bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla [{ColumnPlugin width='3'}] [{ColumnPlugin width='30'}] !!!Sloupec tři bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla [{EndParagraphPlugin}] vygeneruje
Příklad použití dvou sloupcůZápis [{BeginParagraphPlugin}] [{ColumnPlugin width='75'}] !!!Hlavní text bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla [{ColumnPlugin width='5'}] [{ColumnPlugin width='20'}] !!!Poznámky * bla bla bla bla bla bla bla bla bla bla bla * bla bla bla bla bla bla bla bla bla bla bla * bla bla bla bla bla bla bla bla bla bla bla * bla bla bla bla bla bla bla bla bla bla bla * bla bla bla bla bla bla bla bla bla bla bla [{EndParagraphPlugin}] vygeneruje
Psaní vzorcůPro podporu matematických vzorců je v PowerWiki instalován plugin LTMath, který renderuje zadaný výraz ve formátu typografického systému LaTeX na obrázek ve formátu PNG. použití: [{LTMath \int\frac{x^2}{y^2}\,dx }] nebo ekvivalentní zápis [{LTMath latex='\\int\\frac{x^2}{y^2}\\,dx'}] vysází
LaTeXové matematické symboly jsou uvedeny např. zde. Jaké "divočiny" je možné dělat pomocí tohoto pluginu ilustruje demo stránka LTMath pluginu. ParametryPomocí parametru bgcolor můžeme změnit barvu pozadí vzorce, pomocí parametru fgcolor barvu textu. Technicky je přípustná jakákoliv kombinace obou parametrů. Barva se určuje pomocí procentuálního RGB zápisu v šestnáctkové soustavě '#RRGGBB'. Příklady použití
Další příklady barev jsou v následující tabulce:
Hezké rámečkyStandardní zvýraznění textuNově lze ve wiki používat standardních stylů pro zvýraznění textu s jednoduchým zápisem
Zvýraznění pomocí CSS rámečkůPomocí CSS stylů můžete jednoduše vizuálně obohatit vaše stránky. Následují příklady:
%%(width:30%; border-style: solid; border-width: 1px; border-color: #F0C000; background-color: #FFFFCE; text-align:left;) [{nbsp}][Pics/error.png][{nbsp}]poznámka %%
poznámka
%%(width:40%; border-style: solid; border-width: 1px; border-color: #c00; background-color: #fcc; text-align:left;) [{nbsp}][Pics/exclamation.png][{nbsp}]varování %%
varování
%%(width:50%; border-style: solid; border-width: 1px; border-color: #3c78b5; background-color: #D8E4F1; text-align:left;) [{nbsp}][Pics/information.png][{nbsp}]informace %%
informace
%%(border-style: solid; border-width: 1px; border-color: #090; background-color: #dfd; text-align:left;) [{nbsp}][Pics/tip.png][{nbsp}]tip %%
tip
RůznéPřidání nové stránky a hypertextové odkazyKlasickým a preferovaným způsobem je vytvořit někde na vhodném místě ve stávající struktuře stránek hypertextový odkaz na novou wiki stránku. [Text odkazu|NazevStranky] Poté na tento odkaz (zatím prázdný) kliknout a vložit samotný obsah stránky. Pro název stránky prosím nepoužívejte mezery, háčky a čárky. Nejlépe víceslovné názvy, každé slovo začíná velkým písmenem (tzv. velbloudí způsob zápisu). Pokud již stránka existuje, vznikne interní odkaz na wiki stránku. Odkazy na externí webové stránky se vytváří pomocí stejné konvence. Např. odkaz na http://www.google.com se napíše takto [vyhledávač|http://www.google.com] který funguje takto: vyhledávač Editace levého menuNa webovém prohlížeči můžeme rozlišit tři stránky, ze kterých se pohled skládá
Pro editaci jednotlivých částí, klikněte na odkaz. Po otevření na hlavní ploše potom klikněte na dolní nápis Upravit stránku, a můžete editovat. MezeryPro účely formátování jsou občas dobré "nepřerušitelné mezery". Pro to je připravený Nbsp plugin. Použití: text před mezerou [{nbsp count=20}] a text po mezeře text před mezerou a text po mezeře rovněž je dobré dávat [{nbsp}] do prázdných buněk tabulek. Vypadají potom lépe především v IE. Speciální znakyPokud potřebujete některý z těchto znaků, pak jej použijte metodou copy/paste.
Použití fulltextového prohledáváníPowerWiki (JSPWiki engine) obsahuje vynikající prohledávací knihovnu Apache Lucene, která umožňuje flexibilní zadání dotazů. Vyhledávání není case-sensitive, nezáleží na velikosti písmen, základní syntaxe je popsána v příkladech v následující tabulce.
Prohledávanou doménu je možné omezit následujícími prefixy dotazů:
Více detailnějších informací je možné najít přímo na stránce nápovědy Apache Lucene. Uživatelská autorizacePowerWiki přejímá autorizační koncept JSPWiki, který je založen na modelu pomocí bezpečnostních entit jako jsou uživatel, role a uživatelská skupina. Pomocí tohoto modelu si může každý wiki autor omezit, kdo (uživatelé, skupiny) smí provádět jaké aktivity (náhled, editace) nad jeho stránkou. Nejprve je potřeba popsat zmíněné entity. Uživatelské roleVe wiki pracujeme standardně se 4 rolemi. Při prvním připojení dostane automaticky každý roli Anonymous. Po úspěšném přihlášení pomocí uživatelského jména a hesla se změní na roli Authenticated. V následující tabulce je znázorněno, jaké aktivity může standardně provádět která role.
Uživatelské aktivityV levém sloupci Tabulky 1 je seznam všech možných aktivit. V záložkách ve spodní části obrazovky jsou odkazy na tyto aktivity, viditelné pouze když jsou povolené. Pokud chcete editovat stránku, je potřeba se nejdříve přihlásit, a poté bude viditelná např. akce Editovat stránku. Práva na aktivitami nad stránkou pro ostatní autor zadává pomocí speciálního ACL (access control lists) tagu. ACL tagyACL tagy se zapisují do horní části wiki stránky. Jejich syntaxe je [{ALLOW akce kdo}] Která nastavuje, "kdo" (seznamu) smí dělat "akci" s touto stranou.
Př. [{ALLOW view Jana,Michal,Martin}] Stránka je viditelná pouze uživatelům Jana, Michal a Martin. [{ALLOW view Jana,Michal,Martin,Ucitele}] [{ALLOW edit Ucitele}] Strana je viditelná třem uživatelům a všem co patří do skupiny učitelé. Učitelé smí tuto stránku i editovat. Pro umožnění vkládání příloh uživateli Jana je nutné na stránce s ACL tagy přidat: [{ALLOW upload Jana}] Běžný případ stránek určitého předmětu na PowerWiki by tedy mohl vypadat například jako: [{ALLOW view All}] [{ALLOW edit,upload Ucitele}]
POZOR: Nikdy nesmíme zapomenout přidat se do seznamu a současně si přidat i práva pro editace pro sebe (jako autora). Pokud to zapomeneme, pak musíme požádat někoho s právy Admin, který toto pravidlo do stránky přidá.
Implicitní povoleníV rámci zachování logiky akcí v ACL jsou některá práva nastavena automaticky (silnější práva povolí slabší).
Vlastnosti nových verzí JSPWiki |