normal.no - normalnorway/wiki-intern GitHub Wiki
Merk: Fra gammel wiki. Må oppdaterte tekst og formatering.
====== Normals nettside – normal.no ======
===== Innhold =====
Mesteparten av innholdet (dvs. tekst og bilder) på nettsiden kan redigeres her: http://normal.no/admin/
- http://normal.no/admin/flatpages/flatpage/
- http://normal.no/admin/content/content/
- http://normal.no/admin/news/article/
- http://normal.no/admin/links/link/
Tips: Unngå bruk av fet-skrift; bruk kursiv hvis du skal utheve noe. Aldri endre skrifttype, farge, bruke «underline», etc. Det er designerens jobb. Bruk heller «stiler» i editoren – slik at utseende blir konsist for hele nettstedet.
Hovedmenyen kan ikke redigeres via admin-grensesnittet. Den må redigeres via http://git.normal.no/git/normal.no/tree/django/templates/menu.html. Men hovedmenyen skal sjelden redigeres!
Hvis du føler deg litt usikker og er redd for å ødelegge noe, og derfor ikke tør å redigere direkte på normal.no? Da kan jeg glede med at du finner den samme siden på http://dev.normal.no. Der kan du boltre deg fritt, og det spiller ingen rolle om du sletter alt.
==== Navnerom for lenker (URLer) ====
Bakgrunn: Når man først har gjort en lenke/url tilgjengelig på internett, er det ingen vei tilbake. Dvs. det er annsett som ekstremt dårlig praksis å senere endre den. Derfor er det viktig at du tenker deg om //før// du lager en ny lenke. Hvis du ikke liker å tenke på dette, følg systemet beskrevet her. Kilde: http://www.w3.org/Provider/Style/URI.html.en.
URL-navnerommet har en hierarkisk trestruktur. Slik ser den ut for normal.no:
^ Nivå 0 ^ Nivå 1 ^ Beskrivelse ^ | / | | Forsiden (roten av treet) | | /om-normal/ | | | | /bli-medlem/ | | | | ... | | | | /sider | * | Underseksjon for (statiske) sider | | /sider | /om-cannabis/ | normal.no/sider/om-cannabis/ | | /sider | /faq/ | normal.no/sider/faq/ | | ... | | | | /static/ | * | Underseksjon for statiske resurser | | /static/ | /images/ | --> bilder | | /static/ | /css/ | --> stylesheets | | /static/ | /javascript/ | --> javascript | | ... | | | | /diverse | * | Underseksjon for ting som ikke passer andre steder | | /diverse | /kampanje-juni-2014/ | Bra eksempel | | /diverse | /press/ | Dårlig eksempel |
Regel: Aldri lage ny URL i nivå 0! Finn heller en eksisterende seksjon som passer; ev. bruk seksjonen ''diverse''. Er du usikker, ta kontakt med Torkel på 99 32 59 61 eller [email protected].
Eksempel: Du skal legge til en ny side som presenterer ledelsen i Normal. Den er det naturlig å legge //under// ''/om-normal''; altså at den får adressen ''/om-normal/ledelse/''. (Nivå 0 = "/om-normal", Nivå 1 = "/ledelse/").
Alle URLene som er i bruk finner du her:
- http://git.normal.no/git/normal.no/tree/django/website/urls.py
- http://normal.no/admin/flatpages/flatpage/
===== Design og utvikling =====
Vi utvikler for moderne nettlesere og bruker html5 så langt det lar seg gjøre.
Til CSS brukes preprosessoren http://lesscss.org/.
Det brukes foreløbig ikke noe Javascript-bibliotek, men http://jquery.com/ vurderes. Det høres kanskje ut som en kontroversiell besluttning å ikke bruke et Javascript-bibliotek, men i moderne nettlesere er det et mye mindre behov enn det en gang var.
TODO: Laveste versjon av Internet Expolorer vi støtter. IE9?
==== Design ====
MÅL: Stilrent. Ryddig og intuitivt grensesnitt. Ingen bevegelige og/eller distraherende elementer. Unngå animasjoner. Unngå Javascript hvis du kan((og det kan du stort sett)).
- https://developer.gnome.org/hig-book/stable/
- http://developer.android.com/design/get-started/principles.html
- https://developer.apple.com/librarY/mac/documentation/UserExperience/Conceptual/AppleHIGuidelines/Intro/Intro.html#//apple_ref/doc/uid/TP30000894-TP6
- http://www.w3.org/WAI/
==== Utvikling ====
Nettsiden bruker rammeverket Django, er skrevet i programmeringsspråket Python og bruker SQLite som database. For å holde orden på alle filer, og tillate at flere redigerer disse samtidig, brukes versjonskontroll-systemet Git.
Alle endringer loggføres her: http://git.normal.no/git/normal.no/
Og her finner du en «kom-i-gang»-guide: http://git.normal.no/git/normal.no/about/