A-Eskwiki - User contributions [en]

Bestuurswissel

2022-03-03T16:35:25Z

Jason: Add meldpunt

[[Category:WebCie]]

Dit is het stappenplan wat elk jaar bij een bestuurswissel uitgevoerd moet worden. Dit is zo snel mogelijk na de Wissel-AV die in het begin van een nieuw collegejaar plaatsvindt.

Er moeten zowel dingen op de site gedaan worden als in de code.
Natuurlijk moet de sysop ook dingen op het systeem regelen maar dat is hun probleem.

=== Website frontside ===

# Maak een nieuwe commissie aan met login <code>bestuurjjjj</code>.
# Voeg alle mensen die daar in horen toe aan deze commissie.
# Maak een publisher pagina aan voor het huidige bestuur (<code>bestuurjjjj</code>).
# Update de redirects in benamite (<code>/Vereniging/Bestuur</code> en <code>/Vereniging/Commissies/Bestuur</code>)
# Dubbelcheck even of alles nog werkt.

===Backside===
# Check of onderstaande dingen al meteen moeten worden aangepast, het kan best zijn dat een (oud)bestuurslid nog tijdelijk bestuursrechten nodig heeft voor de laatste inwerking of afronding van werkzaamheden.
# Ga naar het BESTUUR DATA deel in <code>space/specialconstants.php</code> en verander alle data hier:
#:* Vul bij <code>BESTUURLOGINNAAM</code> wederom <code>bestuurjjjj</code> in.
#:* Bij mails van de boekencommissaris en de secretaris (gegenereerd door de website) moet natuurlijk de naam staan van het verantwoordelijke bestuurslid. Daarom moet je deze namen invullen in respectievelijk <code>Willem Hulst</code> en <code>Tara Fokker</code>
#:* Update de <code>MELDPUNTMENSEN</code>. Dit zijn mensen die bij het meldpunt zichtbaar zijn, en hun e-mailadressen. Mocht je een regel verwijderen waarbij de key een string is, vergeet dan ook niet het meldpuntForm in `Vereniging.php` te updaten.
# Verander de regel met <code>KANDIDAATBESTUURLOGINNAAM</code> (onder het bestuurdata-blok) in commentaar door "//" voor de regel te proppen.
# Update de inhoud van <code>config.yaml</code> met de nieuwe bestuursleden.

== Kandidaatbestuur aanmaken ==

Het kandidaatbestuur kan aangemaakt worden door een commissie te maken op de site op dezelfde manier als de website frontside. Alle afgelopen jaren is de conventie <code>kbjjjj</code> gebruikt. Doe dit ook, en vul dit in bij <code>KANDIDAATBESTUURLOGINNAAM</code> en zorg ervoor dat het geen commentaar-regel is.

Hektex SVN

2022-02-24T18:45:40Z

Jason:

'''Hektex SVN is vervangen door [https://gitlab.com/iba-aes/latex-packages Git]!'''

Alle packages en scripts die door de [[TeXniCie|TeXniCie]] onderhouden worden, staan onder versiebeheer in de Hektex [http://en.wikipedia.org/wiki/Apache_Subversion SVN].

== Checkout ==

Om wijzigingen aan te brengen in de classes, is het nodig de SVN repository eerst lokaal "uit te checken":
<pre>svn checkout https://www.a-eskwadraat.nl/svn/hektex/
</pre>

Vervolgens log je in met je A-Eskwadraat inloggegevens en verschijnt er het mapje <code>hektex </code>waarin dan de classes in staan.

== Updaten ==
Als iemand een wijziging heeft gecommit naar de SVN-server, is deze nog niet doorgevoerd in je lokale <code>hektex</code> map. Om te zorgen dat je dezelfde versie hebt als de server, doe je:<pre>svn update</pre>

(of korter: <code>svn up</code>). Zie voor een voorbeeldje [[WebCie_SVN#svn_up|WebCie SVN]].

== Status ==
Als je een wijziging maakt in je lokale SVN-map, dan weet SVN dat. Met het commando<pre>svn status</pre>

(of korter: <code>svn st</code>) laat SVN alle bestanden zien die gewijzigd zijn. De bestanden met een M zijn net aangepast, met een A toegevoegd maar nog niet gecommit , met een C conflicted , met een ? nog niet toegevoegd en met een D net verwijderd. Zie [[WebCie_SVN#svn_st|WebCie SVN]].

== Committen ==
Als je de wijzigingen in je lokale SVN-map in de globale SVN wilt aanbrengen dat kun je dat doen met het command<pre>svn commit</pre>
Hiermee breng je de wijzigingen aan bestaande bestanden aan. Als je bestanden wilt toevoegen dan kan dat met<pre>svn add</pre>
Je kan commentaar aan je commit toevoegen door<pre>svn commit -m "text" </pre>

Het is verplicht om commentaar toe te voegen. Als je commit een bug oplost dan kan dat direct via het commentaar.
<pre>svn commit -m "text Closes #bug-id" </pre>

Dit sluit dan direct de bug op de site.

== Structuur ==

De SVN bestaat uit twee mappen de ''Branches'' en de ''Trunk''. In de Trunk staan alle bestanden die ook op het systeem komen. De Branches zijn ervoor om een extra werkende kopie van de SVN te draaien, dit gebruikt men als men groote wijzigingen wilt aanbrengen zonder gevaar te lopen de lokale SVN kapot te maken.

In de Trunk staan een aantal mapjes die hieronder worden toegelicht

=== Classes ===

Hierin staan alle classes die ook op het systeem draaien. Als er kleine bugs opgelost dienen te worden is het het handigst om de wijzigingen hier direct in aan te brengen.

=== Documentatie ===

Hierin staat alle documentatie van de classes.

=== Ibaverklaart ===

Hierin staan de IBA-verklaart van alle classes. Dit wordt op het moment niet gebruikt.

=== Scripts ===

Hierin staan de scriptjes die gebruikt worden. Dit zijn er op het moment twee, de update-classes en de vakidioot scriptjes.

=== Templates ===

Hierin staan templates voor het gebruik binnen een LaTeX-editior.

=== Testfiles ===

Bedoeld om te kijken of de packages nog werken. Hierin staat van elke class een file die getext kan worden om de package te controleren.
[[Category:TeXniCie]]

Hektex SVN

2022-02-24T18:44:21Z

Jason:

'''Hektex SVN is vervangen door [Git](https://gitlab.com/iba-aes/latex-packages)!'''

Alle packages en scripts die door de [[TeXniCie|TeXniCie]] onderhouden worden, staan onder versiebeheer in de Hektex [http://en.wikipedia.org/wiki/Apache_Subversion SVN].

== Checkout ==

Om wijzigingen aan te brengen in de classes, is het nodig de SVN repository eerst lokaal "uit te checken":
<pre>svn checkout https://www.a-eskwadraat.nl/svn/hektex/
</pre>

Vervolgens log je in met je A-Eskwadraat inloggegevens en verschijnt er het mapje <code>hektex </code>waarin dan de classes in staan.

== Updaten ==
Als iemand een wijziging heeft gecommit naar de SVN-server, is deze nog niet doorgevoerd in je lokale <code>hektex</code> map. Om te zorgen dat je dezelfde versie hebt als de server, doe je:<pre>svn update</pre>

(of korter: <code>svn up</code>). Zie voor een voorbeeldje [[WebCie_SVN#svn_up|WebCie SVN]].

== Status ==
Als je een wijziging maakt in je lokale SVN-map, dan weet SVN dat. Met het commando<pre>svn status</pre>

(of korter: <code>svn st</code>) laat SVN alle bestanden zien die gewijzigd zijn. De bestanden met een M zijn net aangepast, met een A toegevoegd maar nog niet gecommit , met een C conflicted , met een ? nog niet toegevoegd en met een D net verwijderd. Zie [[WebCie_SVN#svn_st|WebCie SVN]].

== Committen ==
Als je de wijzigingen in je lokale SVN-map in de globale SVN wilt aanbrengen dat kun je dat doen met het command<pre>svn commit</pre>
Hiermee breng je de wijzigingen aan bestaande bestanden aan. Als je bestanden wilt toevoegen dan kan dat met<pre>svn add</pre>
Je kan commentaar aan je commit toevoegen door<pre>svn commit -m "text" </pre>

Het is verplicht om commentaar toe te voegen. Als je commit een bug oplost dan kan dat direct via het commentaar.
<pre>svn commit -m "text Closes #bug-id" </pre>

Dit sluit dan direct de bug op de site.

== Structuur ==

De SVN bestaat uit twee mappen de ''Branches'' en de ''Trunk''. In de Trunk staan alle bestanden die ook op het systeem komen. De Branches zijn ervoor om een extra werkende kopie van de SVN te draaien, dit gebruikt men als men groote wijzigingen wilt aanbrengen zonder gevaar te lopen de lokale SVN kapot te maken.

In de Trunk staan een aantal mapjes die hieronder worden toegelicht

=== Classes ===

Hierin staan alle classes die ook op het systeem draaien. Als er kleine bugs opgelost dienen te worden is het het handigst om de wijzigingen hier direct in aan te brengen.

=== Documentatie ===

Hierin staat alle documentatie van de classes.

=== Ibaverklaart ===

Hierin staan de IBA-verklaart van alle classes. Dit wordt op het moment niet gebruikt.

=== Scripts ===

Hierin staan de scriptjes die gebruikt worden. Dit zijn er op het moment twee, de update-classes en de vakidioot scriptjes.

=== Templates ===

Hierin staan templates voor het gebruik binnen een LaTeX-editior.

=== Testfiles ===

Bedoeld om te kijken of de packages nog werken. Hierin staat van elke class een file die getext kan worden om de package te controleren.
[[Category:TeXniCie]]

WebCie Accounts

2019-09-30T15:16:10Z

Jason:

[[Category:WebCie]]

== Accounts van de WebCie ==

Als WebCie lid heb je een aantal accounts die nodig/handig zijn. Hieronder een overzicht van alle accounts:

'''Nodig'''

* Systeemaccount (Schop de WebCie voorzitter + bestuur)
* [https://gitlab.com/iba-aes/webcie Gitlab] (Schop de WebCie voorzitter zodra je een account hebt aangemaakt)
* Toegang tot het WebCie root wachtwoord (Schop de WebCie voorzitter voor de uitleg)

'''Optioneel'''
* [https://sentry.io Sentry] - Manier om errors van de website te bekijken. (Schop de WebCie voorzitter)

WebCie Accounts

2019-09-23T17:15:59Z

Jason: Created page with "Category:WebCie == Accounts van de WebCie == Als WebCie lid heb je een aantal accounts die nodig/handig zijn. Hieronder een overzicht van alle accounts: '''Nodig''' *..."

[[Category:WebCie]]

== Accounts van de WebCie ==

Als WebCie lid heb je een aantal accounts die nodig/handig zijn. Hieronder een overzicht van alle accounts:

'''Nodig'''

* Systeemaccount (Schop de WebCie voorzitter + bestuur)
* [https://gitlab.com/ Gitlab] (Schop de WebCie voorzitter zodra je een account hebt aangemaakt)
* Toegang tot het WebCie root wachtwoord (Schop de WebCie voorzitter voor de uitleg)

'''Optioneel'''
* [https://sentry.io Sentry] - Manier om errors van de website te bekijken. (Schop de WebCie voorzitter)

Godrechten

2019-09-23T16:21:35Z

Jason: Zet in juiste categorie

== Policies voor Godrechten ==

Godrechten op de website zijn erg krachtig, ze laten ALLE informatie over ALLE leden zien. Hierom is het belangrijk dat inactieve WebCie'ers hier geen toegang toe houden. Niet zozeer dat we ze niet vertrouwen, maar er is altijd de kans dat ze gehacked worden of andere data perongeluk lekken. Hierom zijn de volgens policies opgesteld:

* Godrechten worden weggehaald als een lid uit de WebCie gaat
* Godrechten worden weggehaald als een WebCie lid voor 2 maanden niet actief is en geen contact heeft opgenomen de WebCie over deze inactiefheid
* Er worden individuele afspraken gemaakt als een WebCie lid wel contact heeft opgenomen met de voorzitter/WebCie
* 'Niet actief' wordt gedefinieerd als geen commits doen en niet op werkavonden komen
* Er kunnen eventueel uitzonderingen gemaakt worden in overleg met de WebCie

[[Category:WebCie]]

Godrechten

2019-09-23T16:17:12Z

Jason: Fix markup issue

Godrechten

2019-09-23T16:16:43Z

Jason: Created page with "== Policies voor Godrechten == Godrechten op de website zijn erg krachtig, ze laten ALLE informatie over ALLE leden zien. Hierom is het belangrijk dat inactieve WebCie'ers hi..."

== Policies voor Godrechten ==

Godrechten op de website zijn erg krachtig, ze laten ALLE informatie over ALLE leden zien. Hierom is het belangrijk dat inactieve WebCie'ers hier geen toegang toe houden. Niet zozeer dat we ze niet vertrouwen, maar er is altijd de kans dat ze gehacked worden of andere data perongeluk lekken. Hierom zijn de volgens policies opgesteld:

- Godrechten worden weggehaald als een lid uit de WebCie gaat
- Godrechten worden weggehaald als een WebCie lid voor 2 maanden niet actief is en geen contact heeft opgenomen de WebCie over deze inactiefheid
- Er worden individuele afspraken gemaakt als een WebCie lid wel contact heeft opgenomen met de voorzitter/WebCie
- 'Niet actief' wordt gedefinieerd als geen commits doen en niet op werkavonden komen
- Er kunnen eventueel uitzonderingen gemaakt worden in overleg met de WebCie

Intro mogelijk maken

2019-08-01T15:27:00Z

Jason: Update het stappenplan

Elk jaar zo rond juli is het weer zover: de intro van het komende jaar is opgestart en ze willen de inschrijvingen opengooien. Als WebCie moet je ervoor zorgen dat de volgende dingen kloppen:

* Geef de introcommissie de juiste auth door de waarde van INTROCIE in <code>www/space/auth/init.php</code> aan te passen
* Ga naar Leden -> Introductie -> Toon Introdeelnemers. Als de secretaris vergeten is om de oude deelnemers te verwijderen doe het dan zelf en schop de secretaris dat hij/zij (of de opvolger) dit na de intro moet doen ivm privacy redenen.
* Maak iDEAL voor kamp mogelijk:
* Maak een Artikel aan in Het Nieuwe Boekenweb 2.0™
* Maak een voorraad aan hiervoor (locatie: virtueel)
* Lever hier meeeeer dan genoeg van (700 ofzo)
* Zet het juiste ID van de voorraad in het register: introKampVoorraad
* Pas specialconstants.php aan en zet de juiste waarde voor MAXAANTALKAMP
* Update de waarde van <code>EJBV</code> in <code>www/space/specialconstants.php</code>, anders wordt "lid vanaf" opeens een jaar te vroeg!
* Maak de verschillende introductie pakketten:
* Maak (lees: Zeg tegen de intro) voor elk pakket een nieuwe activiteit aan. Zet hierbij de titel op iets duidelijks, zoals "Introductiepakket WIS/NAT"
* Zorg dat de iDeal vragen staan ingesteld. Zet hier een beetje nuttige vragen in (Voornaam/Achternaam/Email/verzin wat)
* Voeg kaartjes toe voor de activiteit
* Controleer of de return URL nog klopt, en zet dan de URL als Return URL: http://www.intro-utrecht.nl/?succes=pakket
* Zet extern verkrijgbaar aan
* Zet DigitaalVerkrijgbaar op PERSOONLIJK
* Stel de Verkoopprijs in (let op dat transactiekosten hier nog bovenop komen)
* Ga nu testen of alles werkt
'''Nuttige info:'''

* Om een betaallink te krijgen zonder de A-es layout moet <code>?cleanhtml=true</code> worden toegevoegd.

== Kwerries voor de intro ==

Geef alle mentoren en of ze betaald hebben voor de pakketten. Je moet zelf de juiste activiteitID's en het juiste jaar invullen!
<pre>
SELECT `Lid`.`contactID`, `studentnr`, `voornaam`, `tussenvoegsels`, `achternaam`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7299' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_na_wi_twin`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7298' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_ica_iku_twinfo` FROM `Lid` JOIN `Mentor` ON `Lid`.`contactID` = `Mentor`.`lid_contactID` JOIN `Persoon` ON `Lid`.`contactID` = `Persoon`.`contactID` JOIN `IntroGroep` ON `Mentor`.`groep_groepID` = `IntroGroep`.`groepID` JOIN `IntroCluster` ON `IntroGroep`.`cluster_clusterID` = `IntroCluster`.`clusterID` WHERE `IntroCluster`.`jaar` = 2018
</pre>

Geef alle introdeelnemers en of ze betaald hebben voor de pakketten. Je moet zelf de juiste activiteitID's invullen!
<pre>
SELECT `Lid`.`contactID`, `studentnr`, `voornaam`, `tussenvoegsels`, `achternaam`, `IntroDeelnemer`.*, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7299' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_na_wi_twin`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7298' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_ica_iku_twinfo` FROM `Lid` JOIN `IntroDeelnemer` ON `Lid`.`contactID` = `IntroDeelnemer`.`lid_contactID` JOIN `Persoon` ON `Lid`.`contactID` = `Persoon`.`contactID`
</pre>

[[Category:WebCie]]
[[Category:HowTo]]

Git (WebCie)

2019-06-13T15:55:11Z

Jason: Toevoegen van git hooks

Git (wat staat voor "Git") is het bovennatuurlijke systeem waarmee we controle houden op wat er gebeurt met alle WebCie-code. Als WebCie-lid heb je een kopie (een ''checkout'') van het volledige systeem staan op je eigen account (in de map <code>~/wwwdebug</code>). Deze code bepaalt wat jij te zien krijgt in je browser als je naar je persoonlijke debugpagina gaat (lijkt op <code>https://bla-debug.a-eskwadraat.nl</code>). Als je wijzigingen in deze code aanbrengt, veranderen dus alleen de pagina's op jouw persoonlijke debug-omgeving. Dat noemen we een sandbox, het zorgt er voor dat je rustig je code kan ontwikkelen zonder dat de rest van de WWW daar last van heeft. Bovendien is jouw debugpagina alleen benaderbaar door WebCie-leden, dus als je per ongeluk lekkende SQL-queries schrijft is dat geen ramp.

Op deze pagina staat basale info om aan de slag te gaan met Git. Je kan ook in de [https://git-scm.com/book/en/v2 online handleiding] kijken voor meer pro-tips.

De WebCie is onlangs  overgestapt naar Git. Hierbij is ook de svn-geschiedenis gefilterd, dus pas op bij overstappen!

== Workflow ==

Een ding waar je bij git waarschijnlijk aan moet wennen is dat iedereen een eigen idee heeft van de geschiedenis van alle code. Op de server staan een setje commitgeschiedenissen (oftewel branches), en op je debug staat ook zo'n setje. Met een beetje geluk komen ze ook nog overeen, maar dat hoeft dus niet! Er zijn commando's om van iemand anders de geschiedenis overnemen. Dan krijg je een kopietje binnen van hun geschiedenis, maar wordt jouw geschiedenis ''niet'' aangepast! Je hebt bijvoorbeeld de volgende branches, allemaal opgeslagen in je eigen debug:

* master (jouw laatste editie van de livesite)
* develop (jouw eigen editie van de "echte" code)
* feature-watleuks (jouw eigen editie van deze feature)
* feature-zoveel (een feature waarvan de server nog helemaal niet weet dat die bestaat)
* HEAD (wijst naar de laatste commit die bij jou is gebeurd, dus als het goed is de branch waar je nu op werkt)
* origin/master (wat jij denkt dat de servereditie van de livesite is)
* origin/develop (wat jij denkt dat de servereditie van de "echte" code is)
* origin/feature-watleuks (wat jij denkt dat de servereditie van de deze feature is)

Als je <code>git fetch</code> doet, zal git de laatste versie van elke branch van de server opvragen en die bewaren in origin/$branch. Dan kun je die weer in jouw branches stoppen met bijvoorbeeld <code>git merge</code>. Het commando <code>git pull</code> stuurt jouw editie van de huidige branch naar de server. (De server weet dus in principe niet welke gebruikers er zijn of welke branches ze hebben!)

We hebben twee hoofdbranches: <code>master</code> en <code>develop</code>. De livesite zou gelijk moeten lopen met de branch <code>master</code>, dus we moeten goed opletten wat we daarop zetten. Om makkelijk code te kunnen delen, gaan we in principe alle commits doen op de branch <code>develop</code>, maar het is nog netter om met branches te werken.

Handige commando's om het overzicht te bewaren:

* <code>git log</code> om de commits op je huidige branch te bekijken.
* <code>git log $commit-of-branch-of-etc</code> om de commits op een andere branch te bekijken. (Het is handig om hiervoor ook <code>git fetch</code> te doen.)
* <code>gitk</code> als je beter tegen een grafische interface kan.
* <code>git status</code> toont je branch, hoe die verschilt met origin/$branch en wat je ten opzichte van je branch hebt aangepast
* <code>git branch -a</code> toont elke branch waar git in jouw debug van afweet
* <code>git log --graph --decorate --pretty=oneline --abbrev-commit</code> om in de terminal een mooie gerichte graaf van commits te tonen (<code>--all</code> voor alle branches tegelijk)

=== Maak een feature ===

# <code>git checkout develop</code> en <code>git pull</code> om up to date te zijn
# maak een nieuwe branch met <code>git checkout -b feature-$bla</code>
# ga een stukje zitten programmeren
# heb je nieuwe bestanden toegevoegd: vertel dat aan git met <code>git add $bestand</code>
# wil je bestanden weggooien: doe dat en vertel het tegelijk aan git met <code>git rm $bestand</code>
# wil je kijken wat je allemaal hebt gedaan: gebruik <code>git status</code> en/of <code>git diff</code>
# ben je tevreden met een setje wijzigingen: commit ze met <code>git add $gewijzigd_bestand1 $gewijzigd_bestand2 ...</code> en <code>git commit</code> (het is netjes om eerst nog even te kijken wat je gaat committen zodat er geen troep meekomt)
# herhaal bovenstaande stappen tot je feature helemaal af is
# ben je klaar: stop je feature in develop met <code>git checkout develop</code> en dan <code>git merge feature-$bla</code> en maak het openbaar met <code>git push</code> '''(TODO: Of gaan we helemaal hardcore met pull requests beginnen?)'''
# alle webcie'ers krijgen nu een mailtje met de commits die je hebt gepleegd en zullen je feliciteren en/of afkraken op je programmeerstijl

Nu is werken in je eentje heel leuk, maar samenwerken geeft een veel mooier feestje! Daarom is het aan te raden dat je om de zoveel tijd commits van anderen opvraagt en met ze deelt:

# als iemand anders op je branch heeft gewerkt: doe <code>git pull</code> (krijg je een error in de trant van "geen remote voor branch", doe dan <code>git branch --set-upstream-to origin/feature-$bla</code> om de remote in te stellen en probeer opnieuw)
# als er dingen binnenkomen op develop: stop ze in je branch <code>git fetch</code>'en en dan <code>git merge origin/develop</code>. (Voor echte pro's is er ook <code>git rebase</code>, maar dat heeft meer problemen met samenwerken op de branch)
# als je je vooruitgang wilt delen: doe <code>git push</code> (krijg je een error in de trant van "geen remote voor branch", doe dan <code>git branch --set-upstream-to origin/feature-$bla</code> om de remote in te stellen en probeer opnieuw)

=== Fix een bug ===

(Je kan dit proces ook op develop doen als de bug niet zo heel hoge prioriteit heeft. Doe dan gewoon wat hierboven staat.)

Is er een bug die snel opgelost moet worden? Dan gaan we op basis van de livesite werken zodat we de fix apart kunnen houden van eventuele (halfbakken) features.

# <code>git checkout master</code> en <code>git pull</code> om up to date te zijn
# maak een nieuwe branch met <code>git checkout -b bug-$bla</code>
# doe precies hetzelfde programmeer-commitriedeltje als hiervoor beschreven
# als je in een commit een regel "Closes: #$bugnummer" zet, wordt de bug automatisch op gesloten gezet in Bugweb.
# ben je klaar: stop je fix in master met <code>git checkout master</code> en dan <code>git merge bug-$bla</code> en maak het openbaar met <code>git push</code>
# zorg ervoor dat develop up-to-date blijft: <code>git checkout develop</code> en dan <code>git merge master</code> en maak het openbaar met <code>git push</code>

=== Shit's on fire yo ===

Heb je er een potje van gemaakt, en wil je terug naar de laatste commit? Als je een enkel bestand wil terugzetten, heb je <code>git checkout $bestand</code>; alles wat je in het bestand hebt gedaan sinds de laatste commit wordt dan teruggezet zoals het was. De makkelijkste manier om echt helemaal alles weg te gooien is met <code>git reset --hard HEAD</code>; elk bestand dat je hebt veranderd t.o.v. je laatste commit wordt dan teruggezet zoals het was. Dit kan dus ook nuttige wijzigingen weggooien!

Heb je er een nog erger potje van gemaakt, en heb je een foute commit gemaakt? Als dit de laatste commit(s) was (waren) op je branch en je hebt ze nog niet gepusht, dan heb je <code>git reset HEAD~1</code> om de laatste commit weg te gooien (en <code>HEAD~</code>''n'' om ''n'' commits tegelijk ongedaan te maken.) Heb je ze al wel gepusht, dan moet je naar de aanpak hieronder overgaan.

Heeft iemand anders een enorm potje gemaakt, en wil je de commit ongedaan maken? Doe dan <code>git revert $commit</code>. Dat maakt een nieuwe commit waarin precies het tegenovergestelde gebeurt van die wijzigingen. De originele commit blijft nog wel in de geschiedenis staan! Als iemand dus geheime data heeft gecommit, moet je toch echt [https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History geavanceerde tools gebruiken].

== Om iets live te zetten ==

Ten eerste: denk goed na of je dit echt wel wilt doen. Er kunnen nog wel eens gebruikers gaan klagen.

Doe gewoon een <code>git push</code> naar master op je eigen bakkie. Typ lekker <code>./zetLive.sh</code> in de /scripts map en gaan met die banaan.

== Migreren van SVN naar Git ==

Is jouw debug van voor de overstap? Dan is het niet heel lastig om te switchen!

=== Verhuizen van git-svn ===
Gebruik je al Git-SVN, dan kun je als volgt switchen:
# <code>cd wwwdebug</code>
# <code>git remote add origin ssh://vm-www/srv/git</code>
# <code>git fetch</code>
# <code>git branch -t origin/develop</code>

Nu '''moet''' je handmatig commits van je huidige branches op develop rebasen, want anders gaat de hele geschiedenis stuk. Check dat de 3e commit vanaf het begin begint met <code>9cf65047</code> ipv <code>cc9c5bb</code>. Zo niet, ga je allemaal antieke ledendata meepushen (die ik met pijn en moeite heb weggefilterd) en gaat de Autoriteit Persoonsgegevens je slaan.

=== Verhuizen zonder git-svn ===
Heb je wel een wwwdebug maar nog geen git? Dan moet je iets meer moeite doen om je laatste versie te bewaren:
# <code>cd wwwdebug</code>
# <code>svn up</code>
# <code>svn log</code> Kijk hier wat de laatste revisie is!
# <code>git init</code>
# <code>git remote add origin ssh://vm-www/srv/git</code>
# <code>git fetch</code>
# <code>git commit --allow-empty -m "Initial empty commit"</code> (want git snapt het niet als je geen commit hebt gedaan en wel branches wil beginnen, dan maar zo)
# <code>git log origin/master</code> Kijk hier welke git-commit overeenkomt met de laatste svn-revisie.
# <code>git reset --mixed $laatste_revisie_commit</code>
# <code>git stash</code>
# <code>git checkout -t origin/develop</code>
# <code>git stash apply</code>

=== Vertaalsleutel svn -> git ===

Het belangrijkste verschil is dat git heel veel verschillende commitgeschiedenissen heeft en svn maar eentje. Bij elk commando vraagt svn bijvoorbeeld aan de server of er nog commits bijgekomen zijn. Git doet dat alleen als je erom vraagt met <code>git fetch</code>. Het is daarom een goed idee om als svn'er voor elk commando <code>git fetch</code> te runnen totdat je doorhebt wanneer het echt nuttig is.

* <code>svn up</code> -> <code>git pull</code> (vraag aan de remotes welke veranderingen er zijn, merge die automatisch)
* <code>svn st</code> -> <code>git status</code> (vraag de huidige status op van jouw lokale kopie ten opzichte van jouw laatste commit)
* <code>svn diff</code> -> <code>git diff</code> (bekijk alle wijzigingen die er zijn tussen jouw lokale kopie en jouw laatste commit)
* <code>svn ci</code> -> <code>git commit -a</code> (stop al je wijzigingen in een nieuwe commit, die je zou kunnen opsturen naar de andere WebCie'ers)

== Een nieuwe git-repo opzetten ==

Als je code die niet bij de livesite hoort wilt delen met de WebCie, kan dit via een aparte git-repo. Op deze manier maak je een nieuwe repo:

* <code>ssh vm-www</code>
* <code>cd /srv</code>
* <code>sudo mkdir git-$bla-repo</code>
* <code>sudo chown webcie:webcie /srv/git-$bla-repo</code>
* <code>sudo chmod o= /srv/git-$bla-repo</code>
* <code>sudo chmod ug=rwx /srv/git-$bla-repo</code>
* <code>sudo chmod g+s /srv/git-$bla-repo</code>
* <code>cd /srv/git-$bla-repo</code>
* <code>git init --bare --shared</code>

Nu kun je als het goed is een <code>git clone ssh://vm-www/srv/git-$bla-repo</code> doen!

== Migreren tussen Git-repo's ==

Als de repository ergens anders gehost gaat worden, wil je natuurlijk dat alle huidige code daar terechtkomt.

Stel dat er al een repository is aangemaakt voor de code (e.g. zoals hierboven beschreven), met bijvoorbeeld de URL <code>git.example.com/user/repo</code>.

Een WebCie'r moet dan doen:

* <code>git remote add new-origin $REMOTE_URL</code> — Voeg de nieuwe repository als een remote toe.
* <code>git fetch origin</code> — Haal alles op uit de huidige repository.
* <code>git push new-origin refs/remotes/origin/\*:refs/heads/\*</code> — Hiermee pushen we alles van origin naar new-origin. ([https://stackoverflow.com/questions/23947419 Aldus sprak StackOverflow]) Let wel: misschien pusht dit juist iets te veel. Bij het testen hiervan kwam er bijvoorbeeld een branch op de nieuwe remote met de naam HEAD. Dit moet je dan weer even deleten met e.g. <code>git push new-remote --delete HEAD</code>.
* <code>git remote remove new-origin</code> — Verwijder de remote.

Iedereen doet vervolgens:

* <code>git remote set-url origin $REMOTE_URL</code>

En klaar is Kees! (Hopelijk...)

[[Category:WebCie]]

== Git hooks ==

Om het leven van de WebCie wat makkelijker te maken [https://gitlab.com/iba-aes/webcie/website/snippets/1866213 zijn er git hooks] die verschillende handmatige stappen automatiseren als ze nodig zijn. De volgende dingen zijn geautomatiseerd:

* Het automatisch uitvoeren van <code>./composer install</code>
* Het automatisch uitvoeren van <code>./minify</code>
* Het automatisch uitvoeren van <code>./dia2php</code> en <code>./dia2py</code>

Intro mogelijk maken

2019-05-09T18:16:32Z

Jason: Genders

Elk jaar zo rond juli is het weer zover: de intro van het komende jaar is opgestart en ze willen de inschrijvingen opengooien. Als WebCie moet je ervoor zorgen dat de volgende dingen kloppen:

* geef de introcommissie de juiste auth door de waarde van INTROCIE in <code>www/space/auth/init.php</code> aan te passen
* Ga naar Leden -> Introductie -> Toon Introdeelnemers. Als de secretaris vergeten is om de oude deelnemers te verwijderen doe het dan zelf en schop de secretaris dat hij/zij (of de opvolger) dit na de intro moet doen ivm privacy redenen.
* Maak iDEAL voor kamp mogelijk:
* maak een Artikel aan in Het Nieuwe Boekenweb 2.0™
* maak een voorraad aan hiervoor (locatie: virtueel)
* lever hier meeeeer dan genoeg van (700 ofzo)
* zet de voorraad in <code>www/WhosWho4/Boekweb2/DBObject/iDeal.cls.php</code> op de nieuwe introkampbetaling.
* zet de voorraad en omschrijving in <code>www/WhosWho4/Controllers/Intro.php</code> op de nieuwe introkampbetaling.
* update de waarde van <code>EJBV</code> in <code>www/space/specialconstants.php</code>, anders wordt "lid vanaf" opeens een jaar te vroeg!
* als kandidaatsbestuurders meehelpen met de boekverkoop, geef ze dan ook de benodigde rechten als in [[Bestuurswissel]] omschreven.

== Kwerries voor de intro ==

Geef alle mentoren en of ze betaald hebben voor de pakketten. Je moet zelf de juiste activiteitID's en het juiste jaar invullen!
<pre>
SELECT `Lid`.`contactID`, `studentnr`, `voornaam`, `tussenvoegsels`, `achternaam`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7299' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_na_wi_twin`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7298' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_ica_iku_twinfo` FROM `Lid` JOIN `Mentor` ON `Lid`.`contactID` = `Mentor`.`lid_contactID` JOIN `Persoon` ON `Lid`.`contactID` = `Persoon`.`contactID` JOIN `IntroGroep` ON `Mentor`.`groep_groepID` = `IntroGroep`.`groepID` JOIN `IntroCluster` ON `IntroGroep`.`cluster_clusterID` = `IntroCluster`.`clusterID` WHERE `IntroCluster`.`jaar` = 2018
</pre>

Geef alle introdeelnemers en of ze betaald hebben voor de pakketten. Je moet zelf de juiste activiteitID's invullen!
<pre>
SELECT `Lid`.`contactID`, `studentnr`, `voornaam`, `tussenvoegsels`, `achternaam`, `IntroDeelnemer`.*, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7299' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_na_wi_twin`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7298' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_ica_iku_twinfo` FROM `Lid` JOIN `IntroDeelnemer` ON `Lid`.`contactID` = `IntroDeelnemer`.`lid_contactID` JOIN `Persoon` ON `Lid`.`contactID` = `Persoon`.`contactID`
</pre>

[[Category:WebCie]]
[[Category:HowTo]]

Intro mogelijk maken

2019-05-09T18:15:42Z

Jason: Nieuwe knop om intro deelnemers te verwijderen

Elk jaar zo rond juli is het weer zover: de intro van het komende jaar is opgestart en ze willen de inschrijvingen opengooien. Als WebCie moet je ervoor zorgen dat de volgende dingen kloppen:

* geef de introcommissie de juiste auth door de waarde van INTROCIE in <code>www/space/auth/init.php</code> aan te passen
* Ga naar Leden -> Introductie -> Toon Introdeelnemers. Als de secretaris vergeten is om de oude deelnemers te verwijderen doe het dan zelf en schop de nieuwe secretaris dat die dit na de intro moet doen ivm privacy redenen.
* Maak iDEAL voor kamp mogelijk:
* maak een Artikel aan in Het Nieuwe Boekenweb 2.0™
* maak een voorraad aan hiervoor (locatie: virtueel)
* lever hier meeeeer dan genoeg van (700 ofzo)
* zet de voorraad in <code>www/WhosWho4/Boekweb2/DBObject/iDeal.cls.php</code> op de nieuwe introkampbetaling.
* zet de voorraad en omschrijving in <code>www/WhosWho4/Controllers/Intro.php</code> op de nieuwe introkampbetaling.
* update de waarde van <code>EJBV</code> in <code>www/space/specialconstants.php</code>, anders wordt "lid vanaf" opeens een jaar te vroeg!
* als kandidaatsbestuurders meehelpen met de boekverkoop, geef ze dan ook de benodigde rechten als in [[Bestuurswissel]] omschreven.

== Kwerries voor de intro ==

Geef alle mentoren en of ze betaald hebben voor de pakketten. Je moet zelf de juiste activiteitID's en het juiste jaar invullen!
<pre>
SELECT `Lid`.`contactID`, `studentnr`, `voornaam`, `tussenvoegsels`, `achternaam`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7299' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_na_wi_twin`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7298' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_ica_iku_twinfo` FROM `Lid` JOIN `Mentor` ON `Lid`.`contactID` = `Mentor`.`lid_contactID` JOIN `Persoon` ON `Lid`.`contactID` = `Persoon`.`contactID` JOIN `IntroGroep` ON `Mentor`.`groep_groepID` = `IntroGroep`.`groepID` JOIN `IntroCluster` ON `IntroGroep`.`cluster_clusterID` = `IntroCluster`.`clusterID` WHERE `IntroCluster`.`jaar` = 2018
</pre>

Geef alle introdeelnemers en of ze betaald hebben voor de pakketten. Je moet zelf de juiste activiteitID's invullen!
<pre>
SELECT `Lid`.`contactID`, `studentnr`, `voornaam`, `tussenvoegsels`, `achternaam`, `IntroDeelnemer`.*, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7299' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_na_wi_twin`, (SELECT COUNT(*) FROM `iDealAntwoord` JOIN `Transactie` ON `iDealAntwoord`.`ideal_transactieID` = `Transactie`.`transactieID` WHERE `antwoord` = `Lid`.`studentnr` AND `vraag_activiteit_activiteitID` = '7298' AND `Transactie`.`status` = 'SUCCESS') AS `nr_pakketten_ica_iku_twinfo` FROM `Lid` JOIN `IntroDeelnemer` ON `Lid`.`contactID` = `IntroDeelnemer`.`lid_contactID` JOIN `Persoon` ON `Lid`.`contactID` = `Persoon`.`contactID`
</pre>

[[Category:WebCie]]
[[Category:HowTo]]

Backup

2019-03-13T20:38:26Z

Jason: Voeg instructies toe over encryptie van data

Geregeld worden er '''backups''' gemaakt van een groot deel van het systeem. Hier vallen onder andere de home directories en virtuele machines onder. De WebCie heeft ook een grote hoeveelheid incrementele databasebackups.

== Interne backups ==

De interne backups zijn bedoeld om bestanden terug te kunnen halen die per ongeluk verwijderd zijn. Elke 4 uur, met middernacht als offset, wordt er een recursieve snapshot gemaakt van alle data. Deze 4 uurlijkse snapshots worden, op die van middernacht na, 2 dagen bewaard. De snapshots van middernacht worden standaard 2 weken bewaard, met enkele uitzonderingen zoals de home directories. Deze uitzonderingen plus hun retention tijd staan op haskell in `/etc/cron.daily/managesnapshot`.

Deze 4 uurlijkse backups worden direct gesynced naar de on-site backup in de vorm van Nikola.

Interne backups kunnen makkelijk teruggehaald worden. In het geval van een dataset is er in de root van deze dataset een onzichtbare map .zfs. In het geval van de home kan de staat van 20 november 2015 teruggevonden worden in `/srv/home/.zfs/snapshot/2015112000`. Dit kan alleen op haskell gedaan worden aangezien deze map niet bereikbaar is over NFS. Iets vergelijkbaars kan gedaan wordne met zvol's. Eerst moet echter de property snapdev op visible gezet worden in plaats van hidden en daarna zijn de snapshots van de zvols zichtbaar in `/dev`. Snapshots zijn read-only, dus als je een zvol probeert te mounten die dirty is, dan werkt dit niet als er ext4 op de zvol staat. Ext4 wil bij het recoveren namelijk schrijven, wat niet kan. In een dergelijke situatie kan het vaak handig zijn om een snapshot te klonen en dan te mounten. Met xfs is dit niet nodig.

== Off-site backups ==

We slaan de data ook off-site op bij de universiteit. Dit is een virtuele machine met de naam [[Claude|claude]]. Dit gebeurd vanaf max, aangezien daar een 1:1 kopie staat van de data en op deze manier wordt haskell ontlast. De backups worden vanaf [https://mediawiki.a-eskwadraat.nl/wiki/Claude claude] gepulled vanaf max en door max eerst ge-gzipped en ge-encrypt, zodat de universiteit niet bij onze data kan. Naar [https://mediawiki.a-eskwadraat.nl/wiki/Claude claude] wordt elke eerste dag van de maand een complete kopie gedumped en voor de rest van de maand worden incrementele dumps gemaakt.

== Relevante scripts ==

De volgende scripts en crons die te maken hebben met backups zijn allemaal in gebruik.

*`/usr/local/bin/backupscript` op Haskell maakt elke 4 uur (door `/etc/cron.d/autobackup`) een snapshot en stuurt deze direct naar max.
*`/etc/cron.daily/cleansnapshots` draait op zowel Max als Haskell en ruimt elke dag oude snapshots op. Deze file is identiek op beide machines, dus aanpassingen moeten gesynced worden.
*`/usr/local/bin/pullbackups` op [https://mediawiki.a-eskwadraat.nl/wiki/Claude claude] pullt backups van Max en slaat deze op.
*`/usr/local/bin/cleanbackups`op [https://mediawiki.a-eskwadraat.nl/wiki/Claude claude] ruimt oude snapshots op als de ruimte (2TB) vol dreigt te raken. Vol is >90%. Dit is een cron die elke 5 minuten checkt. Mocht er iets fout gaan zoals dat er bij het opruimen niet tenminste 1 volledige backup altijd bewaard blijft, dan mailt deze dit. Het gebeurd nog wel eens dat de nfs share van de universiteit eruit knalt, en dan flipt dit script ook.

== WebCie: snapshots van de database ==

Op de vm-www maakt een script automatisch elke 10 minuten een dump van de database. Een diff met de vorige db-dump wordt opgeslagen in het archief (<code>haskell:/srv/www/archief</code>): vanaf de [[vm-www]] beschikbaar op <code>/archief/www/2018-08/07/whoswho4.2018-08-07_13_00.diff</code> bijvoorbeeld. Ook wordt elke dag een volledige db-dump opgeslagen. Elke maand worden de volledige dumps en alle diffs samen gecomprimeerd. De dumps kun je gebruiken om per ongeluk gewiste data weer terug te zetten.

=== Backup van binaire logs ===

Omdat het diffprogramma soms te lang deed over het backuppen omdat de diffs heeeeeeeeel lang werden, gaan we de binaire logs gebruiken voor backups.

Als je in de mysql-configuratie de optie log-bin aanzet, zal mysql alle updates aan de databases opschrijven in een logbestand. Dit kun je gebruiken voor [[replicatie]], of voor backups. Elke 10 minuten worden de logs geflusht en alle nieuwe bestanden gekopieerd naar het www-archief. Vervolgens worden de oude logbestanden weggegooid (zodat we niet de volledige geschiedenis steeds opnieuw overnemen). PAS OP: als je replicatie doet en een andere server is offline terwijl de logs worden weggegooid, kan die niet zomaar meer up-to-date komen! Zodra je weer replicatie wilt aanzetten (zoals [[Webcie-vm#Mariadb_en_replicatie|als je een nieuwe VM wilt maken]], moet je dus een goede oplossing hiervoor verzinnen. (Misschien: houd bij welke logbestanden al gekopieerd zijn en sla die over?)

* https://dev.mysql.com/doc/refman/8.0/en/backup-methods.html
* https://dev.mysql.com/doc/refman/8.0/en/binary-log.html
* https://dev.mysql.com/doc/refman/8.0/en/point-in-time-recovery.html

=== Encryptie van de backups ===

Alle WebCie backups worden nu encrypted opgeslagen. De public key die hier voor gebruikt wordt is de "A-Eskwadraat Backup Service <webcie@a-eskwadraat.nl>" key. Deze public key staat geregistreerd in de keychain van de apache user op de vm-www2. Daarnaast is de public key te vinden in [deze](https://gitlab.com/iba-aes/webcie/website/snippets/1835239) Gitlab snippet. De private key wordt bewaard door het bestuur en de WebCie voorzitter.

=== Decrypten van data ===

Is het nodig om de data te decrypten? Volg het volgende stappenplan.

* Vraag het bestuur/de WebCie voorzitter om de USB stick met de private key.
* Importeer de private key: `gpg --import <keynaam>`
* Decrypt de data: `gpg --output <outputfile> --decrypt <inputfile>`
* Verwijder de private key nadat je klaar bent: `gpg --delete-secret-key webcie@a-eskwadraat.nl`

[[Category:Sysop]]
[[Category:WebCie]]

Doxygen

2018-05-15T19:56:45Z

Jason: Doxygen update instructies toegevoegd

'''Doxygen''' is een programma dat volautomatisch code omzet in klikbare documentatiepagina. De documentatie voor de livesite is te vinden op [https://doxygen-www.a-eskwadraat.nl].

= Persoonlijke docusites =

'''WORK IN PROGRESS'''

Dit gaat over het plan van [[User:Timb]] om per debugsite documentatie te genereren. Dan zou voor een <code>$bla-debug</code> de site <code>$bla-docs-debug.a-eskwadraat.nl</code> beschikbaar moeten zijn.

== Gebruik ==

<code>./manage docs</code> genereert documentatie op basis van je huidige wwwdebug. TODO: automatiseer dit dmv een script elke nacht ofzo?

Dit zeurt over een aantal files die Doxygen zou moeten negeren maar dat niet doet. Geen idee waarom.

== Doxygen updaten ==

Omdat CentOS ongelofelijk oud is is de laatste versie van doxygen op de package manager 1.6.1. Om een nieuwere versie te installeren zijn er 2 mogelijkheden:

*Deinstaalleer doxygen als dit nog geinstalleerd is met yum: sudo yum remove doxygen
*Download de binary van http://www.stack.nl/~dimitri/doxygen/download.html
*Verplaats de binary naar /usr/bin/doxygen (Zorg voor -rwxr-xr-x permissies met de file owner as root)

Omdat vooraf gemaakte binaries saai zijn en zo kunnen we het ook zelf compilen!

<code><pre>
git clone https://github.com/doxygen/doxygen.git
cd doxygen
mkdir build
cd build
cmake -G "Unix Makefiles" ..
make
make install
</pre></code>

Verplaats dan de binary van /usr/local/bin/doxygen naar /usr/bin/doxygen

= PHPDoc =

We zouden ook [https://docs.phpdoc.org/ phpdoc] kunnen gebruiken. Binnen de PHP-community lijkt het iets gebruikelijker om phpdoc te gebruiken, namelijk. Bovendien ziet het er gewoon cooler uit :D

Helaas crasht het bij het genereren van documentatie omdat het meer dan 2GB aan RAM / schijfruimte nodig heeft om de hele WhosWho te documenteren. Dus vandaar toch maar gewoon doxygen...

== Installatie ==

<strike><code>pear install phpdoc</code> op de [[vm-www-debug]]</strike> Oh nee, dat is niet stabiel over composer updaten.

Zet het volgende in je <code>composer.json</code>
<code><pre>
"require-dev": {
"phpdocumentor/phpdocumentor": "2.*"
}
</pre></code>
en run <code>./composer update</code>. Dit kost even want het moet erg veel dependencies naar binnen slurpen.

[[Category:WebCie]]

Nieuw WWW-lid

2018-03-19T20:49:16Z

Jason: Git link geupdate en toevoegen aan git repo info

Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:

== Bestuur ==

#Toevoegen aan 'webcie' (inloggen op de server en bij de repo)

== Webcie ==

Ga naar de [[vm-www-debug]] en log in als user webcie:
ssh vm-www-debug
sudo -i -u webcie

Toevoegen aan de htpasswd:
htpasswd /srv/htpasswd $USER
Toevoegen aan de htgroups
vim /srv/config/vm-www-debug/httpd/conf.d/htgroups
vim /srv/config/vm-www/httpd/conf.d/htgroups
Toevoegen aan de wwwdebug.conf
cd /srv/config/vm-www-debug/httpd/conf.d/
vim wwwdebug.sh
./wwwdebug.sh
git commit wwwdebug.sh wwwdebug.conf
git push
sudo service httpd restart
Toevoegen aan de git repo
Vraag aan een momenteel webcie lid om dit te doen

== Nieuw lid ==

Als eerste ga je je eigen debug omgeving aanmaken:

cd /mnt/wwwdebug
mkdir $USER/
cd $USER
git clone https://git.a-eskwadraat.nl/webcie/website.git wwwdebug
cd wwwdebug/www
./manage build --enable-debug --hostname=$bla-debug.a-eskwadraat.nl
ln -s /mnt/wwwdebug/$USER/wwwdebug/ ~/wwwdebug

=== Je eerste commit doen ===

In de root van je website (dat is de map ~/wwwdebug/www/ dus doe als je daar nog niet in zit <code>cd ~/wwwdebug/www/</code>) staat de map space/auth/ met daarin het bestand init.php. Voeg jezelf hier toe bij de $GODNRS. Om dit bestand vervolgens te committen doe je
git commit space/auth/init.php
Vervolgens moet je het bestand pushen zodat de rest van de webcieërs het binnen kunnen halen
git push

[[Category:WebCie]]
[[Category:HowTo]]