Ohjeet: Keskustelun ohjeet

• Viestin kirjoittaminen
• Kooditagit
• Muut muotoilukeinot

Ohjelmointiputkan keskustelualue on tarkoitettu pääasiassa ohjelmointiaiheisille viesteille, mutta muistakin aiheista voi keskustella yleisessä keskustelussa. Keskusteluun ovat tervetulleita kaikki ohjelmoinnista kiinnostuneet iästä, taustasta ja ohjelmointitaidosta riippumatta. Muiden keskustelijoiden kunnioittaminen, kannustaminen ja opastaminen luovat hyvän keskusteluilmapiirin.

Viestin kirjoittaminen

Kirjoita viestille kunnollinen otsikko, josta ilmenee heti viestin aihe. Näin viestisi ei huku muiden samanlaisten sekaan. Esimerkiksi "Ongelma" on huono otsikko, sillä ongelmia voi olla niin monenlaisia. Tarkempi otsikko "Pokerivastustajan tekoäly" kertoo jo paljon enemmän.

Kiinnitä huomiota viestin kieliasuun. Kirjoita viesti niin selkeästi, että sen ymmärtää heti ensi lukemalla. Lukemista helpottavat isot alkukirjaimet, välimerkit ja kappalejako. Muista myös mainita kaikki tarvittavat yksityiskohdat, kuten käyttämäsi ohjelmointikieli. Liitä myös mukaan mahdolliset virheilmoitukset sekä pätkä toimimattomasta koodista.

Voit lainata muiden käyttäjien tekstiä lainaustagien avulla. Pyri lainaamaan vain olennaiset osat; tekstin turha kopioiminen vaikeuttaa keskustelun lukemista jälkikäteen.

Ennen viestin kirjoittamista on hyvä tarkistaa, onko Ohjelmointiputkassa ollut aikaisemmin keskustelua samasta asiasta. Sivun oikeassa ylänurkassa olevalla hakukoneella voit etsiä yhtä aikaa vanhoista keskusteluista, koodivinkeistä ja oppaista. Kannattaa myös kokeilla Google-hakua.

Kooditagit

Kun liität viestiin koodia, kirjoita sen ympärille kooditagit. Silloin kaikki merkit ovat yhtä leveitä ja sisennykset eivät katoa. Joillekin ohjelmointikielille on omat väritetyt kooditagit. Uusia värityksiä tulee toisinaan eikä kaikkia näistä ole lueteltu alla, joten tunnettujen kielten nimiä voi itsekin kokeilla viesteissä.

[koodi]Morjens![/koodi]

Morjens!

[koodic]
#include <stdio.h>
int main(void) {
    printf("Morjens!");
}
[/koodi]

#include <stdio.h>
int main(void) {
    printf("Morjens!");
}

[koodiphp]
if (true) {
  echo "Morjens!";
}
[/koodi]

if (true) {
  echo "Morjens!";
}

[koodiqb]PRINT "Morjens!"[/koodi]

PRINT "Morjens!"

[koodisql]
SELECT * FROM taulu WHERE luku = 123
[/koodi]

SELECT * FROM taulu WHERE luku = 123

Muun muassa seuraavat väritykset ovat jo olemassa:

Muitakin kielten nimiä tai lyhenteitä voi käyttää; uusia värityksiä lisätään tarpeen mukaan. Jos kieli on tuntematon, koodi jää värittömäksi kuten ensimmäisessä esimerkissä.

Muut muotoilukeinot

Voit käyttää viesteissä seuraavia muotoilumerkintöjä:

auki: [h], kiinni: [/h]

http://www.ohjelmointiputka.net/

[linkki "http://www.php.net/"]PHP[/linkki]

[lainaus "Antti Laaksonen"]Mitä mieltä olette?[/lainaus]

[t]teksti[/t]

[l]käytä[/l]

[k]säästeliäästi[/k]

2[yl]3[/yl] = 8

H[al]2[/al]O

[lip]
[lik]apina
[lik]banaani
[/lip]