Keskustelu: Nettisivujen teko: Tutoriaalisivusto (projekti)

Oon tällasta turtoriaalisivustoa kehitellyt tässä samalla kehittäessäni CMS-järjestelmääni. Sivusto tulee keskittymään ohjelmointiin ja softapuoleen. Haenkin nyt innokkaita ihmisiä kirjottelemaan oppaita sivustolle.

Tämä on siis ihan alussa ja tällä hetkellä siellä ei olekaan vielä muuta kun oma keskeneräinen PHP oppaani. Sivu on osoitteessa: http://jouluserver.com/~matso/tutorz.web/?cat­=Etusivu

Jos kiinnostuit ja omaat hyvän kirjoitustaidon sekä tiedät jostain asiasta paljon, niin ota yhteyttä vaikka maililla matso165[ät]gmail[piste]com mielellään jonkun näytteen kera.

Rikoin sun käyttöehtojasi heti, sillä selaimeni kopioi sivut välimuistiinsa, pyydän syvästi anteeksi...

Mitenköhän tämä "Kaikki kopioiminen kielletty!" menisi lakiasiantuntijalla läpi, kyse on kuitenkin nettisivu?

Jos haluat ilmoittaa, millaiset käyttöehdot sisällöllesi tarjoat, käytä esim. Creative Commonsin valmiita lisenssejä.

Onkos CMS omaa käsialaasi? Haluaisitko valoittaa muillekin käyttäjille esim. ylläpitopuolen ominaisuuksia yms.?

Lebe80 kirjoitti:

Rikoin sun käyttöehtojasi heti, sillä selaimeni kopioi sivut välimuistiinsa, pyydän syvästi anteeksi...

Mitenköhän tämä "Kaikki kopioiminen kielletty!" menisi lakiasiantuntijalla läpi, kyse on kuitenkin nettisivu?

Jos haluat ilmoittaa, millaiset käyttöehdot sisällöllesi tarjoat, käytä esim. Creative Commonsin valmiita lisenssejä.

Onkos CMS omaa käsialaasi? Haluaisitko valoittaa muillekin käyttäjille esim. ylläpitopuolen ominaisuuksia yms.?

Juu on. Ei toi silleen mikään hirveen ihmeellinen. Kuitenkin tärkeimmät perusominaisuudet löytyy. Uusia sivuja saa lisättyä kätevästi jos käyttäjällä on riittävät oikeudet tuohon ja samasta lomakkeesta määritetään aikalailla kaikki jutut, eli voi valita listasta suoraan jos haluaa sen jonkun alakategoriaksi ja silleen.

Toi sivujen hallinta hoituu siis lähinnä yhellä lomakkeella ja sitten jos on riittävät oikat niin sielä näkyy sivuilla muokkaus ja poisto linkit.

Todella harva jaksaa alkaa kirjoittelemaan oppaita täysin tuntemattomalle sivustolle, jossa ei ole edes paljon kävijöitä...

Mikset voi laittaa tutoriaalejasi ohjelmointiputkaan? ;)

T.M. kirjoitti:

Todella harva jaksaa alkaa kirjoittelemaan oppaita täysin tuntemattomalle sivustolle, jossa ei ole edes paljon kävijöitä...

Mikset voi laittaa tutoriaalejasi ohjelmointiputkaan? ;)

Googlellakaan ei ollut edes paljon kävijöitä sillon kun se oli indeksoinut 10 sivua. Jostain täytyy aloittaa, ja pyrinkin itse tekemään parhaani. Mitä enemmän tulee sisältöä sitä enemmän saa luultavasti kävijöitä ja sitä enemmän innostaa tehdä sisältöä.

Jeah, ei vain tullut kauhean motivoitunut mielikuva ylläpitäjästä, kun pyydetään jo muita tekemään hommia puolestasi, kun sivusto ei sisällä vielä juuri mitään. Eli jos eka tekis ite ~10 laadukasta opasta, ja sit kattoo jos joku jaksais tonne mitään lisätä niiden lisäksi... muutenkin aika heikolta näyttää että kukaan jaksaisi tehdä toisten sivuille oppaitaan, vaatii aika paljon vakiokävijöitä kunnes ihmiset jaksavat oppaitaan tunkea toisten sivuille...

Hyvä keino saada niitä kävijöitä olisi kirjoittaa opas aiheesta, josta ei vielä ole opasta, tai opppaat on huonoja.

Näyttää hyvältä, kunnes alkaa lukea sisältöä: sattuu silmään. Kauhea kontrasti lukea valkoista tekstiä mustalta pohjalta, ja vielä siten että sivulla on silti paljon valkoista sen mustan ympärillä.

(Tosin tätä vielä enemmän viiltää HTML:n puolella kauhea divien yliviljely: missä ovat kappaleet, missä ovat otsikkotagit, missä ovat listat? Tökkää CMS:ään vaikka TinyMCE, niin se kyllä huolehtii kappaleet ja otsikot helposti kuntoon.)

Hyvistä oppaiden kirjoittajista on tunnetusti huutava pula, mutta itse voi onneksi näyttää esimerkkiä. Jos sivustoa päivittää säännöllisesti ja sisältö on kunnollista, kävijöitä on myös tiedossa sankoin joukoin.

Mielestäni tuo oli ihan mielenkiintoinen. Valkoinen väri mustalla pohjalla oli mielestäni miellyttävä ja muutenkin sivun ulkoasu oli ihan kiva. Opasta nyt en jaksanut sen kummemmin lukea, enkä muutakaan räplätä, joten sen kummemmin en osaa sanoa. Mutta eikun jatkamaan vaan ja tekemään.

lainaus:

Tosin tätä vielä enemmän viiltää HTML:n puolella kauhea divien yliviljely: missä ovat kappaleet, missä ovat otsikkotagit, missä ovat listat?

No onhan sielä otsikoissa käytetty <h> tageja. Ja miten niin divien liikaviljelyä? Taulukoitako sinne sitten pitäs tunkea? Ei sielä mielestäni hirveesti sellasia divejä oo jotka olis paremmin jollain toisella keinolla saanut tehtyä.

Oppaita pyrin tekemään itse kyllä sitä tahtia kun jaksaa, ja jos joku on sitä puolikasta opasta vilkassu, niin olis kiva kuulla mielipiteitä, onko riittävän selkeesti kerrottu jne.

Onhan noita PHP oppaita hirveesti jo, mutta se nyt on ehkä yks vahvimmista osaamisalueistani, niin täytyyhän sellanen tehdä sitten, niin saa alkuun jotain kunnollista opasta...

<?php
$arvo = 4;
if($arvo == 4){
echo "Luku on 4<br>";
}
if($arvo > 3){
echo "Luku on enemmän kuin 3<br>";
}
?>

Sisennykset olisi myls hyvä laittaa koodiin, niin olisi mielekkäämpää lukea.
Itse Lukisin mieluummin alla olevaa koodia. Onhan se tietenkin vähän mielipide kysymyskin, mutta mielestäni ainakaan oppaissa ei voi olla liikaa sisennyksiä ( no aina voi), eikä välejä erottelemassa koodeja toisistaan, jotta sitä on helpompi lukea ja sisäistää

<?php

$arvo = 4;

if($arvo == 4)
{
    echo "Luku on 4<br>";
}
if($arvo > 3)
{
    echo "Luku on enemmän kuin 3<br>";
}

?>

Sekä jos käytät <br> tagia esimerkiksi tuon pätkän yhteydessä, se olisi mielestäni hyvä sinne kommentoida mikä sen tarkoitus on. Okei, oppaat yleensä luetaan alusta loppuun ja tuon merkitys pitäisi olla tuossa vaiheessa selvä, mutta joskus sitä voi joku hyppiä ja jäädä ihmettelemään mikä tuo <br> on, varsinkin kun se on tuossa yhteydessä nyt hieman turha. Eihän sen jälkeen tule enää mitään.

Ja jos kerrot if, ja else rakenteesta, olisi mielestäni järkevää kertoa myös else if mahdollisuudesta. :D

Tässä jotain omaa mielipide ******...

Joo noi sisennykset puuttuu jostain, toisissa kohdissa taas on, se johtuu siitä, että tein noita lähinnä tekstieditorilla jossa sitten käytin tabia, no mulla ei ole tossa toistaseks mitään tabien tunnistusta. Olisko jollain tietoa millä merkillä voi kuvata tabia, että sais replace lauseen tehtyä?

/t

muistaakseni

Matso kirjoitti:

Oppaita pyrin tekemään itse kyllä sitä tahtia kun jaksaa, ja jos joku on sitä puolikasta opasta vilkassu, niin olis kiva kuulla mielipiteitä, onko riittävän selkeesti kerrottu jne.

Oppaiden sisältö on ihan hyvää, mutta kieliasussa olisi vielä parantamista. Lukuisat yhdyssanavirheet ja pilkkuvirheet häiritsevät lukemista, ja teksti vaikuttaa paikoin muutenkin viimeistelemättömältä. Oppaita kirjoittaessa kannattaa todellakin pyrkiä selkeyteen ja miettiä, millaiselle lukijalle opas on tarkoitettu. Kohderyhmästä riippumatta kannattaa välttää epämääräisiä vieraskielisiä sanoja (esim. aloituskappaleen "dynaaminen" ja "interaktiivinen") ja yrittää ilmaista suomeksi se, mitä varsinaisesti tarkoittaa.

Myös koodiesimerkkejä olisi selkeämpi lukea paremmalla fontilla (tasavälisellä), niinkuin esim. tällä foorumilla on. Tuollaisissa muutaman rivin skripteissä ei eroa juurikaan näe, mutta hieman pitemmissä auttaa jo suuresti.

Koodiesimerkit voi laittaa <pre> tagiin, jolloin tabulaattorien sisennykset tulevat mukaan ilman eri kikkailuja. Ja tämän vuoksi olisi hyvä myös sisältöteksti asettaa kappaleisiin, jolloin niillekin saa omaa sisennystään ja kappaleiden väliä saisi säädettyä paremmin, irrallisesti esim. juuri koodiesimerkeistä.

Kaikki sisältötekstien otsikot ovat divejä:

<br><br><div class="header1">Taustatietoa</div><br>

Merri kirjoitti:

Koodiesimerkit voi laittaa <pre> tagiin, jolloin tabulaattorien sisennykset tulevat mukaan ilman eri kikkailuja.

Tuossa on pieni huono puoli, nimittäin tabit näkyvät selaimessa aivan liian pitkinä.