= Server =

== Kvar att dokumentera ==
- [ ] Puppet-instalation

== Framtida att göra ==
- [ ] Ldap-server för
    - [ ] Styrelseposter
    - [ ] Medlemsregister

--------------------------------------------------

http://vastgota.nation.liu.se

Det här är den officiella dokumentationen över hur Västgöta Nation i
Linköpings webbsida fungerar.

Sidor hostas av Lysator mailto:root@lysator.liu.se

- Debian 11
- Wordpress genom pakethanteraren
- Nginx för HTTP

== Kataloger ==
`/srv/styrelse` :: Delade filer för styrelsemedlemmar
`/srv/stupan-backup` :: Säkerhetskoppiering från stupan, se [[#Systemkonton]]

== Epost ==
Servern kör en skapligt standard postfix-installation, tillsamans med
dovecot för IMAP-access.

E-postlistor administreras i filen `/etc/aliases`. Kom ihåg att köra
`newaliases` efter ändringar där.

Varje konto vilken ska kunna ta emot epost behöver en katalog
`~/Maildir`, samt tillåtas på Lysators mailserver.

För att läsa och skicka e-post, anslut med extern klient enligt
[[mail]]

== Användarkonton ==
Konton är alla Unix-konton i botten.
Varje styrelsepost har ett eget konto, övriga personkonton kan finnas.

=== Användare ===

`passwd _username_` :: Byt löserord på konto
`usermod -c "_Förnamn Efternamn_" _username_` :: Uppdatera "verkligt" namn på konto
`usermod -aG sudo _username_` :: Ge användare root-rättigheter
`gpasswd -d _username_ sudo` :: Ta bort root-rättigheter från användare

==== Postspecifika konton ====
aktivitet      :: 1001
info           :: 1002
intendent      :: 1003
kassor         :: 1004
lokal          :: 1005
medlem         :: 1006
pq             :: 1007
propaganda     :: 1008
qurator        :: 1009
sekreterare    :: 1010
guckel         :: 1011
valberedningen :: 1012

==== Systemkonton ====
stupan-backup :: 997
    :: Tar emot dagliga backups från Ättestupans dator

==== Övriga konton ====
lysroot :: 1000
    :: Lysators administratörskonto, får inte tas bort
rehnman :: 1013
    :: Betrodd person med root-rättigheter

=== Grupper ===
vastgota :: 1001
styrelse :: 1002

{{{sh
useradd -G vastgota <user>
}}}

= Webbsida =
http://vastgota.nation.liu.se/

Västgöta Nations webbsida kör för nuvarande Wordpress. Det temat som
körs (Blogeasy) är valt för att det var det som såg minnst skit ut.

== Design ==

{{{css class="right"
/* Fullständig CSS-listning */

.main-nav-bg,
.slicknav_menu {
	background-color: #FFe500;
}
.main-navigation a,
.slicknav_nav a {
	color: #100b08;
}
.main-navigation a:hover,
.slicknav_nav a:hover {
	color: #707070;
    
}
.sub-menu .menu-item {
	background-color: #FFe500;
}
.btn {
	background-color: #FFe500;
	border-color: #100b08;
	color: #100b08;
}

.site-footer {
	background-color: #ffe500;
	color: darkgrey;
}
.site-footer a {
	color: #100b08;
}
.site-footer a:hover {
	color: #707070;
}

#content a {
	color: blue;
}

#content a::visited {
	color: purple;
}

#content .entry-meta a {
	color: #002e5b;
}

#content header a {
	color: #002e5b;
}

#content aside a {
	color: #002e5b;
}

#content footer a {
	color: #002e5b;
}

#content a.btn {
	color: #100b08;
}

.datestr, .datesep {
	font-family: monospace;
}

td.eventful {
    background-color: #FFe500;
    border-radius: 20%;
}

td.eventful-today {
	border-radius: 20%;
}
}}}

För att få temat i stil med föreningen har nedan följande CSS lagts
till. Det den framförallt gör är att byta ut alla mörkblå element mot
Västgöta-gula (`#FFe500`).

Full CSS-listning till höger.

=== Förbättringar ===

Menyalternativ med barn markeras för nuvarande inte på
skrivbordsversionen av webbsidan (dock på mobilversionen). Någonting i
stil med följande bör användas.

{{{css
.menu-item-has-children > a:after {
	content: " V";
	font-size: 80%;
	color: red;
}
}}}

`.menu-item-has-children` är den interesanta biten.

== Karta ==
På https://vastgota.nation.liu.se/attestupan/ finns en karta till
stupan. I skrivandets stund använder den
[[https://leafletjs.com/|LeafletJS]] vilket bygger på
[[https://www.openstreetmap.org/|OpenStreetMap]].


== Ansvariga för Stupan ==

Ett minde PHP-tillägg finns också (se nedan). Vilket kör genom "Code
Snippets" pluginet. Koden kan, vid behov, portas till annat format
utan större besvär. Dock är den inget vidare.

Det lägger till shortcoden `[ansvariga]`, vilket ger en
lista på ansvariga för Stupan. Informationen fås från filen
`/etc/vastgota/ansvariga`, och är på formen:
{{{
2018-10-12 Hugo
}}}
Altså ISO-8601 datum, följt av ett mellanslag och ett namn. Mellanslag
får förekomma i namnet. Rader som börjar med `#` är kommentarer, end
of line kommentarer stödjs inte.

Shortcoden tar ett argument, `back`, vilket är hur många veckor backåt
mistorik ska visas. Om inget argument ges visas full historik. På
ättestupans webbsida visas historik fyra veckor bakåt, samt så länkas
det till en sida med full historik.

=== ICal ===
Det finns också ett python-script (listat nedan) vilket läser igenom
filen och dumpar ut det till en icalendar blob. Tyvärr kör den inte
för nuvarande för att servern inte hade något bra sätt att integrera
godtyckliga script.

=== Kommentar från /etc/vastgota/ansvariga ===
{{{sh
# The following is a list of people responsible for Ättestupan.
# Each line should contain an ISO-8601 formatted date (YYYY-MM-DD),
# followed by a space and finally any number of characters which make
# out the name.
# Entries should be placed in chronological order.
# Refrain from deleting old entries unless totally necessary.
}}}

=== Text till webbsida ===
https://vastgota.nation.liu.se/attestupan/ansvariga/

Just nu står det

    Vi behöver inget snöre

Jag tror det duger bra.

=== Kodlistning ===

{{{php
<?php
add_shortcode( 'ansvariga', function ($atts) {
  $a = shortcode_atts( array(
	"back" => 0
	), $atts);

  if ($a["back"] == 0) {
	$back = false;
  } else {
  	$back = strtotime("-". $a["back"] . " weeks");
  }

  $retstr = "";
  $retstr .= "<ul>";
  $ansvariga = array();
  $contents = file_get_contents("/etc/vastgota/ansvariga");
  $lines = explode("\n", $contents);
  foreach ($lines as $row => $data) {
    if ($data == "") continue;
	if ($data[0] == "#") continue;
    $row_data = explode(" ", $data, 2);
    $ansvariga[$row_data[0]] = $row_data[1];
  }

  $now = time();
  foreach ($ansvariga as $datestr => $person) {
    // We compare with the day after since they are responsible for the evening.
    $then = strtotime($datestr) + 3600 * 24;
	if ($back != 0 && $then < $back) continue;
    $retstr .= "<li>";
    if ($now > $then) { $retstr .= "<del>"; }
    $retstr .= "<span class='datestr'>$datestr</span> <span class='datesep'>::</span> <span class='dateper'>$person</span>";
    if ($now > $then) { $retstr .= "</del>"; }
    $retstr .= "</li>";
  }
  $retstr .= "</ul>";
  return $retstr;
} );
}}}

{{{python
#!/usr/bin/env python3

# Simple program for generating a vcalendar of people responssible for
# Ättestupan. Runs as a CGI script.
# TODO Currently doesn't check that a line doesn't contain more that
# 75 octets.

vcal_fmt = """BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Västgöta Nation/2.0/
{}
END:VCALENDAR"""

vevent_fmt = """BEGIN:VEVENT
UID:vg_ansvarig_{date}@vastgota.nation.liu.se
DTSTART:{date}T190000
DTEND:{date}T220000
SUMMARY:Stupan: {ansvarig} ans.
END:VEVENT
"""

# Should DTSTAMP be added, should signal when the event was created,
# which I can probably just set to the generation time (running time
# of this script)k

def get_vcalendar(ansvarig_file):
    """
    Returns a string containing a vcalendar of all people
    responsible.
    """
    str = ""
    with open(ansvarig_file, "r") as f:
        for line in f:
            line = line.replace("\n", "")
            if not line: continue
            if line[0] == "#": continue

            date, ansvarig = line.split(" ", 1)
            str += vevent_fmt.format(date=date.replace("-", ""), ansvarig=ansvarig)

    return vcal_fmt.format(str).replace("\n", "\r\n")

def get_header():
    return """HTTP/1.1
Connection: Close
Content-type: text/calendar
"""

if __name__ == "__main__":
    print(get_header())
    print(get_vcalendar("/etc/vastgota/ansvariga"))
}}}

---------------

All kod på den här sidan är manuellt inklippt. Skillnader från det som
faktiskt körs kan finnas.

= Skrivare =
- [[https://support.brother.com/g/b/downloadtop.aspx?c=se&lang=sv&prod=dcpl2520dw_us_eu|DCP-L2520 DW]]
- Bläck
  - Enligt Brother
    - TN-660
    - TN-630
  - Enligt CDON, på produkten
    - [[https://cdon.se/hushallsapparater/lasertoner-brother-tn-2310-p40388232|TN-2310]]

= Telefon =
- `*120#` för att visa abonemangsstatus.
ord

= WP cli =
*För nuvarande körs inte det här systemet*.

https://github.com/wp-cli/wp-cli
Installerat till `/usr/local/bin/wp`. I början av
`/usr/share/wordpress/wp-config.php`, precis efter `<?php` har
följande lagts till:

{{{php
if (defined ('WP_CLI') && WP_CLI && ! isset ($_SERVER['HTTP_HOST'])) {
	$_SERVER['HTTP_HOST'] = 'vastgota.lysator.liu.se';
}
}}}

python3-dateutil

{{{sh
wp post create \
    --post_author=1 \ # kör `wp user list` för att få id
    --post_date=2020-03-23 \
    --post_content="<pre>`cat file.txt`</pre>" \
    --post_title='Veckomail v.13' \
    --post_status=publish \
    --post_category=Veckomail
}}}

https://git.lysator.liu.se/hugo/wp-publish-by-email

= Veckbrev mailproxy =
:TODO:

Veckbrev bör automatiskt publiceras på webbsidan då de skickas till
listan... Uppnås troligen enklast genom att lägga till
publish@vastgota.lysator.liu.se (eller liknande) på listan, och låta
servern fånga upp det.

{{{
# /etc/postfix/relay/*_recipients
test@vastgota.lysator.liu.se OK

$ postmap vastgota_recipients
}}}