User-friendly Code

[en] The World-Wide Web has made the world a virtual community. What underpins the internet? Code. Programs. Programmers provide the threads of the web; they tie us all together, and give us the ability to communicate. Lately I've seen some really user-friendly code out there. User-friendly because a user may actually be able to read and understand it. The variables and comments can be read with ease, because they're in Esperanto. The finer points of English are beyond a lot of people, but anyone can learn and comprehend Esperanto. So when someone reads someone else's code that is commented in Esperanto, or even better, also has the variable names in Esperanto, the chances of understanding the functioning of the program are increased. An example is Paturage, which is a beautiful photo/document album.

[eo] La interreto ŝanĝis la mondon en virtualan komunumon. Kio estas la fundamenta framo de la interreto? Kodo. Programoj. Programistoj provizas la fadenojn de la reto; ili kunligas nin, kaj donas la eblon por komuniki. Lastatempe mi vidas kodon kiu vere estas afabla -- afabla ĉar oni ja havas ŝancon legi kaj kompreni ĝin. La variablojn kaj komentojn oni povas legi facile, ĉar ili estas en Esperanto. La subtilaĵoj de angla estas preter la kompreno de multaj personoj, sed ĉiu povas lerni kaj kompreni Esperanton. Tial, kiam vi legas kodon kiun programisto komentis en Esperanto, aŭ eĉ pli bone, ankaŭ havas Esperantigitajn variablonomojn, la ŝancoj ke vi komprenos la funkciadon de tiu programo pliiĝas. Jen, ekzemplo kiun mi donos estas Paturage, kiu estas bela foto/dokumentoalbumo:

$kunteksto = new PGKunteksto('lumbildo');

$datumbazo = new PGDatumbazo();

$datumbazo->konektu();

if($kunteksto->chuAdministristo()) {

// Laŭnecese, ĝisdatigu artiklon

if($kunteksto->leguArgumentonPriFarendaRedaktOperacio() != 'NENIO') {
require_once('redakta-kontrolisto.php');

ghisdatiguArtiklon();

}

}

$artiklo = $kunteksto->leguArgumentonPriArtiklo();

if(!$kunteksto->chuGasto() || !$artiklo->chuPrivata()) {

// Se vidigado estas permesita, kreu vidaĵon kaj vidigu la paĝon

$vidajho =PGFabriko::leguLumbildanVidajhonPorArtiklo($artiklo); $kadro = new PGLumbildoKadraVidajho($vidajho); $kadro->vidigu();

} else {

// Se vidigado ne estas permesita, reiru al la patra paĝo

// kaj vidigu erarmesaĝon

header("Location: ".$kunteksto->leguURLonAlPatraPagho('epriv')); }