Wikikirjan (wikibook) luominen, miten ja millä?

[Marko5]

Hei,

Yrityksessä mietitään laatukäsikirjan päivittämistä ja word-dokumentteja siirtyy sinne ja tänne.
Tiedostoissa muotoilut on sikinsokin ja viittauksien tekeminen kovan työn takana eri tiedostojen välillä.

Nyt olisi tarkoitus löytää helppo ja yksinkertainen tapa ylläpitää muutoksia kyseisessä teoksessa.
Olen yrittänyt löytää tietoa miten laittaa wikikirja pystyyn siinä onnistumatta. Ei löydy edes wikikirjaa aiheeseen liittyen.

-Tarkoitus olisi numeroida otsikot: 1.otsikot,  1.1 aliotsikot ja 1.1.1 aliotsikko.
-Viittaaminen tietenkin helpoksi.
-Kirja on mahdollista saada pdf-tulosteena eli generoi pdf-tiedoston, Ubuntu tutuksi oppaan tapaan.

Mikä wiki vaikuttaisi lupaavimmalta ja mihin saa tulevaisuudessa päivityksiä?

[Asmo Koskinen]

Mikä wiki vaikuttaisi lupaavimmalta ja mihin saa tulevaisuudessa päivityksiä?

Wikimedia?

http://wikimediafoundation.org/wiki/Home/

Wikimedia+Ubuntu?

"Oct. 09, 2008 The operator of the popular Wikipedia website has reportedly standardized its 400 servers on Ubuntu."

http://www.linux-watch.com/news/NS6069835429.html

Wikimedia+Ubuntu+Installation?

http://www.mediawiki.org/wiki/Manual:Installation

Ystävällisin terveisin Asmo Koskinen.

[Jakke77]

http://www.mediawiki.org/wiki/MediaWiki/fi

[SuperOscar]

Wikejähän löytyy joka lähtöön:

http://en.wikipedia.org/wiki/Comparison_of_wiki_software

Itse tein joskus wikin TikiWikillä, joka nykyään on nimeltään TikiWiki Groupware/CMS, ja minusta se oli oikein helppokäyttöinen ja sisälsi kuitenkin riittävästi ominaisuuksia. Sitä ennen olin kokeillut MoinMoinia, koska se on kirjoitettu Pythonilla eikä PHP:llä kuten useimmat, ja Pythonia haltsaan itsekin. MoinMoinin lähinnä kokeilukäyttöön tarkoitettu työpöytäpainos (ei tarvitse palvelinta) toimi hyvin, mutta muuten ohjelman ominaisuudet ja säädöt tuntuivat loppuvan kesken.

[Marko5]

Kiitos vastauksista.

Tiedän kyllä mistä wiki ja miten, mutta millä tuotteella ja miten saa aikaiseksi wikikirjoja.
Tarkoitus on tosiaan muuttaa monistenippu (laatukäsikirja) sähköiseksi tietolähteeksi.
Laatukäsikirja pitää sisällään satoja sivuja ja otsikot pitää numeroida niin vaikuttaisi siltä, ettei perinteinen wiki oikein taivu siihen.
Tarkoitan siis, että "Laatukäsikirja" otsikon alle samalle sivulle ei kannata kerätä kaikkia aihealueita esim. tietojärjestelmät, käyttäjähallinta, tietoturva.

En tunne wikitekniikkaa kovin hyvin, enkä osaa arvioida tarvitaanko toiminnallisuuteen kenties lisäosa tms.
Tästä syystä kyselenkin täältä.

-Marko

[Asmo Koskinen]

Tiedän kyllä mistä wiki ja miten, mutta millä tuotteella ja miten saa aikaiseksi wikikirjoja.

Tutki lisää täältä:

 Strategies for creating PDF from Mediawiki

* The Eclipse Wikipedia Editor with PDF Exporter
* Collection is an extension that you can install in your own Mediawiki. It will allow a user to organize personal selections of pages in a collection. Collections then can be structured with chapters, exported in ODF, DocBook or PDF using other extensions or ordered as print book through pediapress.
* Extension:PdfBook is an extension that can generate PDF from a page with a list of links, e.g. a category page. All pages found in the link will be assembled into a single HTML page and then processed with the Htmldoc server script."

http://edutechwiki.unige.ch/en/Wiki_book

Tämä "Collection" saattaisi tehdä sen mitä haluat. Huomaa - Beta.

http://www.mediawiki.org/wiki/Extension:Collection

Ystävällisin terveisin Asmo Koskinen.

[Vapaan koodin kananmuna]

Kiitos vastauksista.

Tiedän kyllä mistä wiki ja miten, mutta millä tuotteella ja miten saa aikaiseksi wikikirjoja.
Tarkoitus on tosiaan muuttaa monistenippu (laatukäsikirja) sähköiseksi tietolähteeksi.
Laatukäsikirja pitää sisällään satoja sivuja ja otsikot pitää numeroida niin vaikuttaisi siltä, ettei perinteinen wiki oikein taivu siihen.
Tarkoitan siis, että "Laatukäsikirja" otsikon alle samalle sivulle ei kannata kerätä kaikkia aihealueita esim. tietojärjestelmät, käyttäjähallinta, tietoturva.

En tunne wikitekniikkaa kovin hyvin, enkä osaa arvioida tarvitaanko toiminnallisuuteen kenties lisäosa tms.
Tästä syystä kyselenkin täältä.

Idea kuulostaa hyvältä ja olen joskus toteuttanut vähän vastaavanlaisen projektin, eli sisäisen dokumentaation siirron wikiympäristöön. Pistin perus mediawiki asennuksen, autentikointi AD:hen ja muutama plugari lisää. Joku pdf-muotoon pullauttava pluginikin oli, mutta tekisin homman mieluummin kuitenkin nykyisin jollain parserilla LaTeX sorsaksi ja siitä sitten pdflateksilla ulos.
Hyödyllisiä plugareita mediawikiin tollaisessa projektissa on esim. CategoryTree, jolla  saa näppärästi hoidettua navigointitarpeet. Teet nykyisen laatukäsikirjan luvuista kategorioita ja alaluvuista sitten yksittäisiä sivuja. Jos tälle linjalle lähdet niin joudut luultavasti käyttämään sivujen ja kategorioiden nimissä staattista numerointia, että saat ne oikeaan järjestykseen.

Projektin onnistuminen riippuu pitkälti siitä miten saat organisoitua sisällön ja sisällön sisäiset linkkaukset. Käyttäjät on myös saatava aktivoitua, esim. wysiwyg-editoriplugarin lisääminen voi auttaa joitakin käyttäjiä (vaarana tosin on, että muotoilut tehdään tälläisellä työkalulla väärin). Suurin työ varmaan kumminkin on siinä kun siirtää olemassaolevat dokumentit sinne wikiin.

[Asmo Koskinen]

Idea kuulostaa hyvältä ja olen joskus toteuttanut vähän vastaavanlaisen projektin, eli sisäisen dokumentaation siirron wikiympäristöön. Pistin perus mediawiki asennuksen, autentikointi AD:hen ja muutama plugari lisää. Joku pdf-muotoon pullauttava pluginikin oli, mutta tekisin homman mieluummin kuitenkin nykyisin jollain parserilla LaTeX sorsaksi ja siitä sitten pdflateksilla ulos.
Hyödyllisiä plugareita mediawikiin tollaisessa projektissa on esim. CategoryTree, jolla  saa näppärästi hoidettua navigointitarpeet.

Kokeilin tätä.

http://173.45.225.152/kirjasto/index.php/Etusivu

Asensin hiekkalaatikkooni äsken Mediawikin ja Collection-laajennuksen (viimeisin svn-versio).

Koodia: [Valitse]

root@asmok:/var/www/kirjasto/extensions# svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Collection
A    Collection/Collection.i18n.php
A    Collection/Collection.php
A    Collection/Collection.alias.php
A    Collection/README.txt
A    Collection/Version.php
A    Collection/collection
A    Collection/collection/remove.png
A    Collection/collection/show.png
A    Collection/collection/collection.js
A    Collection/collection/jquery.ui.js
A    Collection/collection/json2.js
A    Collection/collection/up.png
A    Collection/collection/down.png
A    Collection/collection/jquery.js
A    Collection/collection/trans.png
A    Collection/Collection.body.php
A    Collection/Collection.templates.php
Checked out revision 48837.
root@asmok:/var/www/kirjasto/extensions#

 Laajennuksesta sanotaan näin (README):

"If you have a low-traffic MediaWiki you can use the public render server running at http://tools.pediapress.com/mw-serve/. In this case, just keep the configuration variable $wgCollectionMWServeURL (see below) at its default value."

Myös tämä vaaditaan.

"Note that the MediaWiki must be accessible from the render server, i.e. if your MediaWiki is behind a firewall you cannot use the public render server."

Joten tein niin, muutin/lisäsin nämä rivit LocalSettings.php-tiedostoon. Muisti oli aluksi 20, siitä tuli herjaa, joten nostin sen 64:ään. Muuten mediawiki on niin oletus kuin voi olla pelkän asennuksen jäljiltä. Noh, oman kuvan vaihdoin yläkulmaan.

Koodia: [Valitse]

# If PHP's memory limit is very low, some operations may fail.
ini_set( 'memory_limit', '64M' );


Koodia: [Valitse]

$wgEnableApi = true;

require_once("$IP/extensions/Collection/Collection.php");

$wgCollectionMWServeURL = ("http://tools.pediapress.com/mw-serve/");

----

Kokeilkaa tuota, luokaa oma sivu ja katsokaa miten se renderöityy pdf-tiedostoksi! ODT-tiedostomuotokin olisi mahdollista, mutta sitä en nyt kokeillut, vaatinee oman renderöinti-palvelimen.

Jos ilmenee väärinkäytöksiä, vedän töpselin pois seinästä...

----

Koska Collection -laajennoskin on GPL:ää, niin tuo kaikki on vapaasti muokattavissa oman yrityksen/yhteisön käyttöön.

Ystävällisin terveisin Asmo Koskinen.

[Asmo Koskinen]

Kokeilkaa tuota, luokaa oma sivu ja katsokaa miten se renderöityy pdf-tiedostoksi! ODT-tiedostomuotokin olisi mahdollista, mutta sitä en nyt kokeillut, vaatinee oman renderöinti-palvelimen.

Siinä vasemmassa laidassa alhaalla on kohta "PDF-versio".

Mutta myös "Luo kirja" - katsokaapa sitä!

Ystävällisin terveisin Asmo Koskinen.

[Asmo Koskinen]

Mutta myös "Luo kirja" - katsokaapa sitä!

Niin siis - tämä on se sama laajennus, jolla tehdän ne Wiki-kirjat...

http://fi.wikibooks.org/wiki/Wikikirjasto:Etusivu

Ystävällisin terveisin Asmo Koskinen.

[Tomin]

http://fi.wikibooks.org/wiki/Wikikirjasto:Etusivu

Päivän kirja

Ubuntu tutuksi
Olet hankkinut tai olet hankkimassa Ubuntu linuxia, ja haluaisit oppia käyttämään tätä käyttöjärjestelmää? Tämä Wikikirja on kuin tehty sinulle.

Kuinkas sattuikaan...

[Asmo Koskinen]

Koska Collection -laajennoskin on GPL:ää, niin tuo kaikki on vapaasti muokattavissa oman yrityksen/yhteisön käyttöön.

Eli näitä wikikirja/pdf-renderöinti-palvelujakin näköjään löytyy, mutta GPL antaa yhteisölle/yritykselle/koululle/osaavalle mahdollisuuden muokata näistä työkaluista juuri sellaisen palvelun itselleen kuin haluaa. Hienoa juttu taas kerran.

Ystävällisin terveisin Asmo Koskinen.

[Vapaan koodin kananmuna]

Kokeilkaa tuota, luokaa oma sivu ja katsokaa miten se renderöityy pdf-tiedostoksi! ODT-tiedostomuotokin olisi mahdollista, mutta sitä en nyt kokeillut, vaatinee oman renderöinti-palvelimen.

Siinä vasemmassa laidassa alhaalla on kohta "PDF-versio".

Mutta myös "Luo kirja" - katsokaapa sitä!

Ystävällisin terveisin Asmo Koskinen.

Todella hienoa jälkeä tulee.

[Asmo Koskinen]

Asensin hiekkalaatikkooni äsken Mediawikin ja Collection-laajennuksen (viimeisin svn-versio).

Asensin OpenID-laajennuksen (viimeisin svn-versio). Kuvakaapapus ohessa.

http://www.mediawiki.org/wiki/Extension:OpenID

Koodia: [Valitse]

root@asmok:/var/www/kirjasto/extensions# svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/OpenID/
A    OpenID/OpenID.i18n.php
A    OpenID/openid_table.sql
A    OpenID/OpenID.hooks.php
A    OpenID/SpecialOpenIDServer.body.php
A    OpenID/openid_table.pg.sql
A    OpenID/SpecialOpenIDLogin.body.php
A    OpenID/OpenID.alias.php
A    OpenID/README
A    OpenID/SpecialOpenID.body.php
A    OpenID/SpecialOpenIDConvert.body.php
A    OpenID/SpecialOpenIDFinish.body.php
A    OpenID/SpecialOpenIDXRDS.body.php
A    OpenID/OpenID.setup.php
A    OpenID/OpenID.php
A    OpenID/TODO
A    OpenID/optionToTable.php
 U   OpenID
Checked out revision 48860.
root@asmok:/var/www/kirjasto/extensions#

Muutin asennustiedostoa tietokantaa varten, käytän kirjasto_ -etuliitettä.

Koodia: [Valitse]

root@asmok:/var/www/kirjasto/extensions/OpenID# cat openid_table.sql
CREATE TABLE kirjasto_user_openid (
  uoi_openid varchar(255) NOT NULL,
  uoi_user int(5) unsigned NOT NULL,
 
  PRIMARY KEY uoi_openid (uoi_openid),
  UNIQUE INDEX uoi_user (uoi_user)
) TYPE=InnoDB;
root@asmok:/var/www/kirjasto/extensions/OpenID#


Koodia: [Valitse]

root@asmok:/var/www/kirjasto/extensions/OpenID# mysql -h localhost -u kirjasto -p kirjasto < openid_table.sql
Enter password:
root@asmok:/var/www/kirjasto/extensions/OpenID#

Näiden jälkeen piti vain luoda oma OpenID-tunnus ja ryhtyä sitä käyttämään. Jos $wgTrustRoot-riviä ei ole määritelty/lisätty kirjautuminen ei onnistu.

Koodia: [Valitse]

require_once("$IP/extensions/OpenID/OpenID.setup.php");

$wgTrustRoot = ("http://173.45.225.152/kirjasto/");
----

Joten sinulla on jokin OpenID-tunnus, niin sitäkin voi kokeilla tuossa hiekkalaatikossa. Oikeassa ylälaidaas on kirjautuminen jollakin OpenID-tunnuksella.

----

Ajattelen taas koulumaailmaa - Mediawiki näillä kahdella laajennoksella (OpenID ja PDF) on todella käyttökelpoinen. Etsin vielä sen, että voiko Mediawikin lukita anonyymikäyttäjiltä. Vai onko se vastoin Mediawikin luontoa?

----

Muuten, hiekkalatikossa on Ubuntu 8.10 Server, siinä löytyy suoraan pakettivarastoista tarvittavat php-laajennokset.

Collection - apt-get install php5-curl
OpenID - apt-get install php-openid php5-gmp

Ystävällisin terveisin Asmo Koskinen.

[ylläpito on poistanut liitteen]

[Vapaan koodin kananmuna]

Ajattelen taas koulumaailmaa - Mediawiki näillä kahdella laajennoksella (OpenID ja PDF) on todella käyttökelpoinen. Etsin vielä sen, että voiko Mediawikin lukita anonyymikäyttäjiltä. Vai onko se vastoin Mediawikin luontoa?

Lisäksi vaikka se ldap-auth, jolla pääsee opettajat jo mahdollisesti olemassa olevilla tunnuksilla sisään (jos siis AD löytyy). Siinä olet kyllä oikeilla jäljillä että mediawikiä ei varsinaisesti ole tehty rajoitettavaksi. Jotain rajoitustoiminnnallisuuksia kuitenkin on eli yksinkertaiset suojaukset kuten koko wikin lukitseminen anonyymikäyttäjiltä onnistuu. Lisäksi ainakin etusivua koskevat monimutkaisemmatkin säännöt on mahdollisia, mutta mitään kovin hyvää tapaa esimerkiksi sisällön näkyvyyden rajoittamiseen käyttäjäryhmittäin ei ole. Jotain lisäosia monimutkaisempiin sääntöihin löytyy, mutta ovat käsittääkseni enemmän tai vähemmän purkkaa.

[Marko5]

Kiitos tuhannesti!
Mukava huomata, että asiasta innostuttiin ja hyviä lisäominaisuuksia on tuotu esille.
 
Tärkein vastaus oli kuitenkin, että kyseinen järjestely on mahdollista.
Täytyy tehdä kunnon määrittelyt resursseista kyseiseen projektiin, ettei homma kuivu heti alkumetreillä.

-Marko

[Asmo Koskinen]

Siinä olet kyllä oikeilla jäljillä että mediawikiä ei varsinaisesti ole tehty rajoitettavaksi. Jotain rajoitustoiminnnallisuuksia kuitenkin on eli yksinkertaiset suojaukset kuten koko wikin lukitseminen anonyymikäyttäjiltä onnistuu.

Kokeilin tätä.

http://www.tacticaltechnique.com/how-to/stop-mediawiki-spam/

Koodia: [Valitse]

$wgWhitelistAccount = array ( "user" => 0, "sysop" => 1, "developer" => 1 );

$wgGroupPermissions['*']['edit'] = false;

Jos kirjaudun OpenID-tunnuksella, niin voin muokata etusivua, jos en ole kirjautunut, niin saan tällaisen ilmoituksen.

"Lähdekoodi
sivulle Etusivu

Sinulla ei ole lupaa muokata tätä sivua seuraavasta syystä johtuen:
Pyytämäsi toiminto on rajoitettu ryhmän käyttäjät henkilöille.

Voit tarkastella ja kopioida tämän sivun lähdekoodia"

@VKK - Riittäisikö tämä pahimmalta vandalismilta ja spämmäämiseltä?

@VKK - Siirrä tämä ketju samalla tuonne palvelin-osastoon, ei enää niin yleistä keskustelua.

Ystävällisin terveisin Asmo Koskinen.

[Vapaan koodin kananmuna]

@VKK - Riittäisikö tämä pahimmalta vandalismilta ja spämmäämiseltä?

@VKK - Siirrä tämä ketju samalla tuonne palvelin-osastoon, ei enää niin yleistä keskustelua.

Siirretty, mietin siirtoa jo vähän aikaisemmin.
Kyllähän tuon luulisi poistavan suuren määrän spämmistä. Puukottaisin silti ehkä kumminkin vielä login-formia ja lisäisin siihen vaikkapa jonkun suomenkielisen captcha tyyppisen jutun, esim. vaikkapa email nimellä html-sorsaan merkityn kentän jossa kysytään käyrää hedelmää. Sitten if-lauseke login formin tarkastuksen ympärille, joka tarkistaa onko kentän arvo 'banaani', jos ei ole niin homma jää siihen ja jos siitä löytyy sähköpostiosoite (@-merkki) niin mahdollisesti jopa blokkilistalle.
CAPTCHA juttuja löytyy toki valmiinakin, mutta aina se on kivempi tehdä itse. 

[Asmo Koskinen]

@VKK - Riittäisikö tämä pahimmalta vandalismilta ja spämmäämiseltä?

Poistin tunnukset tietokannasta. Anonyyminä en voi muuttaa etusivua, mutta kun olen kirjautunut OpenID-tunnuksella sisään ja samalla valinnut tunnuksen mediawikiin, niin nyt voi muokata etusivua.

Minusta tämä riittää.

1. Oppilaat luovat itselleen OpenID-tunnuksen.
2. Kirjautuvat sillä Mediawikiin.
3. Kun Mediawiki pidetään palomuurin ulkopuolella (DMZ), niin voidaan käyttää PDF-renderöintipalvelua.

Jos halutaan, niin laitetaan Mediawikin hakemisto lisäksi salasanan taakse.

http://dagobart.wordpress.com/2008/11/09/a-primer-to-setting-up-mediawiki-as-a-private-slip-box/

Ystävällisin terveisin Asmo Koskinen.

[Asmo Koskinen]

CAPTCHA juttuja löytyy toki valmiinakin, mutta aina se on kivempi tehdä itse. 

Kiitos, näitä tosiaan on valmiina kuvilla ja ilman.

Ystävällisin terveisin Asmo Koskinen.