Tarkastaaksesi versiosi <code>weechat --version</code> tai <code>weechat-curses --version</code>. Mikäli versionumero on kauheasti 2.1 alla, harkitse vakavasti päivittämistä, ks. https://weechat.org/download/debian/
On suositeltavaa avata WeeChat joko tmuxiin tai screeniin, tämä tapahtuu ensin antamalla komento <code>tmux</code> ja siirtymällä seuraavaan kappaleeseen tai <code>screen weechat</code> (en ole screen-käyttäjiä). Palataksesi tmuxiin myöhemmin, <code>tmux attach</code>
Käynnistä WeeChat komennolla: <code>weechat</code> tai erittäin vanhan version kohdalla <code>weechat-curses</code>
[[Kuva:2018-05-29-weechat1.png|1000px]]
''Kuvien alin palkki tulee mukautetusta tmuxista ja se voi näyttää hiukan erilaiselta.''
Lisää PirateIRC antamalla WeeChatissa komento:
<code>/server add pirateirc roubaix-fr.pirateirc.net/6697,stockholm-se.pirateirc.net/6697,sydney-au.pirateirc.net/6697 -ssl -autoconnect</code>
[[Kuva:2018-05-29-weechat2.png|1000px]]
Halutessasi saat muuten hiiren käyttöösi <code>/mouse enable</code>.
Yhdistä palvelimelle <code>/connect pirateirc</code>
Nyt voit liittyä kanaville <code>/join #piraatit,#piraattinuoret,#toiminta</code>.
[[Kuva:2018-05-29-weechat3.png|1000px]]
Voit vaihtaa nimimerkkiä <code>/nick uusinimimerkki</code> tai tehdä sen pysyvästi <code>/set irc.server.pirateirc.nicks nimimerkki,nimimerkki2,nimimerkki3</code>
'''MUISTA TALLENTAA ASETUKSESI''' <code>/save</code>
Suosittelen lukemaan myös muut WeeChat-ohjeet tältä sivulta (automaattinen sisäänkirjautuminen, kanavien tallennus).
==== Automaattinen sisäänkirjautuminen ====
Tässä ohjeessa käytetään SASLia, joka kirjaa käyttäjän sisälle ennen ei-opereille näkymistä ja täten myös ennen kanaville liittymistä:
Asetetaan käyttäjätunnus ja salasana:
<code>/set irc.server.pirateirc.sasl_username KAYTTAJATUNNUS</code><br/>
<code>/set irc.server.pirateirc.sasl_password SALASANA</code>
Tallennetaan asetukset
<code>/save</code>
Yhdistetään verkkoon uudelleen, jotta nähdään kaiken toimivan odotetusti.
<code>/reconnect</code>
==== IRCv3 ====
IRCv3 tuo IRChen useita hyödyllisiä ominaisuuksia, joita WeeChat ei vielä ota oletuksena käyttöön. Saat ne käyttöösi:
<code>/set irc.server_default.capabilities account-notify,away-notify,cap-notify,extended-join,multi-prefix,server-time,userhost-in-names,znc.in/server-time-iso,znc.in/self-message</code> (varoitus: copy-pastetettu Mikaelan WeeChat 2.2-dev:sta)
* https://github.com/weechat/weechat/issues/320
==== Vinkkejä ====
* Kanavien muistaminen:
: Asenna skripti autojoin.py: <code>/script install autojoin.py</code>
: Liittyessäsi uusille kanaville, suorita <code>/autojoin --run</code> ja tallenna muutetut asetukset <code>/save</code>
: Seuraavan kerran käynnistäessäsi WeeChatin, kanavalistasi pitäisi pysyä samana.
* Hiiren käyttöönotto:
: <code>/mouse enable</code>
* Rivien kopioiminen ja pitkien linkkien klikkaaminen
: Paina ALT + L tai suorita <code>/window bare</code>
: WeeChat siirtyyy bare-display modeen piilottaen kaikki palkit, kunnes painat mitä tahansa näppäintä.
* Kanavapalkki vanhoilla WeeChatin versioilla:
: <code>/script install buffers.pl</code>
* Värejä!
: /names <code>/set irc.look.color_nicks_in_names on</code>
: nimilistassa <code>/set irc.look.color_nicks_in_nicklist on</code>
* PirateIRCn asetukset, jos palvelin oli valmiiksi lisätty ennen suojatun yhteyden pakkoa:
: <code>/set irc.server.pirateirc.addresses roubaix-fr.pirateirc.net/6697,stockholm-se.pirateirc.net/6697,sydney-au.pirateirc.net/6697</code>
:: ''Tehdään oletus, että käyttäjä haluaa Suomen Piraattien palvelimen mennessä alas yhdistää Ruotsin Piraattien palvelimelle ja sielläkin ollessa ongelmia Australian Piraattien palvelimelle (jonka jälkeen kiertää alusta).''
: <code>/set irc.server.pirateirc.ssl on</code>
'''HUOM! /SCRIPT on tuettu alkaen ?.?'''
=== Ohjeet Irssin käyttöön ===
[[Tiedosto:Hexchat-2.png]]
[[Tiedosto:Hexchat-3.png|400px]]
Klikataan automaattisesti lisättyä palvelinta ja muutetaan palvelimeksi 'irc.piraattipuolue.fi/6697' (SSL-portti) ja laitetaan halutut rastit ruutuun.
Aloita rekisteröitymällä kirjoittamalla nimesi, sähköposti-osoitteesi (oikea) ja salasanasi. Vahvistettuasi sähköposti-osoitteen voit lisätä uuden verkon.
[[Tiedosto:irccloud-mikaela-1.png|1000px]]
Kirjoita palvelimen osoite <code>irc.piraattipuolue.fi</code>, portti <code>6697</code> ja koska <code>6697</code> on SSL-portti, klikkaa myös <code>Secure port</code> rasti ruutuun.
Nyt kun olet tehnyt verkon asetukset, paina vain <code>Join network</code>-
[[Tiedosto:irccloud-mikaela-2.png|1200px]]
Tervetuloa PirateIRChen. Kanavan nimi ja aihe lukee IRCCloudin yläosassa, sen alla on kanavalla tapahtuvat asiat (liittymisen/poistumiset/lopettamiset/kirjoitukset), jonka alla taas on palkki, jonne voit itse kirjittaa viestisi kaikilla kanavilla oleville.
== PirateIRC-palvelut ==
=== NickServ ===
'''Nickserv''' on PirateIRCssä pyörivä palvelu, joka antaa mahdollisuuden suojata oma käyttäjätunnus siten, etteivät muut pääse käyttämään sitä.
==== Rekisteröityminen ====
''Tähän ehkä kaivattaisiin esimerkkejä siitä mitä NickServ ja muut sanovat.''
Aloita avaamalla keskustelu yksityinen keskustelu NickServin kanssa komennolla <pre>/query NickServ</pre>
Sano sille <pre>register salasana sähköposti@example.com</pre> korvaten salasanan ja osoitteen oikeilla tiedoilla. NickServ lähettää sinulle sähköposti-osoitteen varmistusviestin, jossa on komento, joka tulee kopioida ja liittää NickServille.
===== Vaihtoehtoisen nimimerkin rekisteröiminen =====
# <code>/nick Mikaela_</code> vaihtaaksesi nimimerkkiäsi
# <code>/msg NickServ identify Mikaela salasana</code> kirjautuaksesi sisään käyttäjänä Mikaela ellet ole jo
# <code>/msg NickServ GROUP</code> yhdistääksesi nimimerkin Mikaela_ sisäänkirjautuneen tunnuksen alaisuuteen
==== Sisäänkirjautuminen ====
Sisäänkirjautumiseen on neljä yleisesti käytettyä tapaa:
* <pre>/msg NickServ identify nimimerkki salasana</pre>
* Palvelimen salasanan asettaminen muotoon salasanaksi
* SASL ('''suositeltu'''). SASL kirjaa sinut sisään automaattisesti ennen kuin edes näyt verkossa (muille kuin IRC-operaattoreille). Ks. asiaskasohjelmien ohjeet aiemmin tällä sivulla tai [https://freenode.net/sasl freenoden SASL-ohjeet (englanniksi)].
* CertFP (asiakasohjelman puoleinen SSL-certificaatti), ks. [https://freenode.net/certfp freenoden certfp-ohjeet (englanniksi)].
==== Hyödyllisiä asetuksia ====
* <code>SET ACCOUNTNAME RyhmitettyNimimerkki</code> vaihtaa käyttäjätunnukseksi Ryhmitetyn nimimerkin
* <code>SET EMAIL uusi.sahkposti@example.net</code> vaihtaa sähköposti-osoitetta
* <code>SET EMAILMEMOS on/off</code> lähettää [[Irc-ohje#MemoServ|MemoServ]]-viestit sähköpostiin
* <code>SET ENFORCE ON</code> estää muista käyttämästä nimimerkkiäsi ellei hän kirjaudu sisään ajoissa
* <code>SET PASSWORD uusisalasana</code> asettaa salasanaksesi uusisalasana
==== Lisäohjeita ====
Komenna NickServille ''help'', niin se listaa tarjotut vaihtoehdot. Lisätietoja voi saada komennolla ''help komennonnimi''.
=== HostServ ===
'''HostServ''' tarjoaa vhosteja eli virtuaalisia isäntänimiä. Esimerkiksi Mikaelan hostina näkyy vep.mikaela.info:n sijaan PirateParty/FI/Member. Huomaa, etteivät nämä yleisestä uskomuksesta huolimatta piilota oikeaa IP-osoitetta. Ks. [https://gist.github.com/maxteufel/1e2cf7ada079c271bd3c (Englanniksi) About Security of unaffiliated cloaks at freenode].
* Avaa keskustelu HostServin kanssa, ''/query HostServ''
* Katso lista saatavilla olevista vhosteista sanomalla ''offerlist''
* Valitse jokin kivannäköinen vhost ja ota se käyttöön sanomalla esimerkiksi ''take fi.pirate''
* Sano ''on'' ja vhostisi pitäisi olla käytössä.
Vhostisi tulee aina näkyviin kirjautuessasi sisälle. Mikäli et käytä SASLia ja liityt kanavalle ennen sisäänkirjautumista, muut näkevät että liityt oikealla hostillasi ja poistut viestillä "Changing host" ja liityt vhostillasi.
=== ChanServ ===
'''ChanServ''' on tarkoitettu lähinnä IRC-kanavien ylläpitäjille. Se tarjoaa automaattisia toimintoja kanavan hallinnointiin.
Lisäohjeita: <code>/msg ChanServ help</code>
==== Kanavan rekisteröiminen ====
# Liity kanavalle ja varmista sinulla olevan opit (mode +o tai @ nimimerkin edessä). <code>/join #kanava</code>
# <code>/msg ChanServ register #kanava</code>
==== Yleisiä toimenpiteitä ====
* Oppien lisääminen perus-op-lipuilla (TODO: SELITÄ NE): <code>/msg ChanServ flags #kanava !piraatti-opit AOP</code>
*: Antaa opit ryhmän !piraatti-opit jäsenille.
* Auto-voicen ja perus-vop-lippujen lisääminen: <code>/msg ChanServ flags #kanava !piraattibotit VOP</code>
*: Antaa voicen !piraattibotit ryhmän jäsenille.
* Pääsyn poistaminen kokonaan henkilöltä: <code>/msg ChanServ flags #kanava NIMIMERKKI/!RYHMÄ/$EXTTARGET -*</code>
==== Hyödyllisiä asetuksia ====
* <code>SET #KANAVA ANTIFLOOD ON/QUIET/KICKBAN/OFF</code> ottaa käyttöön ChanServin tulvimisen eston kanavalle.
*: ON tarkoittaa PirateIRCssä quiet, joka on lievennetty bänni ja estää ainoastaan puhumisen ja mahdollisesti nimimerkkien vaihdon kanavalla.
* <code>SET #KANAVA ENTRYMSG Kanavalle liittyessä näytettävä viesti</code>
* <code>SET #KANAVA PREFIX <merkki></code> oletuksena !, merkki jolla voidaan käyttää ChanServiä suoraan kanavalla, esimerkiksi * <code>!kick Nimimerkki</code>
==== Piraattisetup ====
Mikaela on pystyttänyt piraattikanavia näin:
Mikäli kanavan opit ovat olleet hukassa, ensimmäinen vaihe on ollut IRC-operaattorina <code>/msg OperServ mode #kanava +o Mikaela</code> (älä kokeile, aiheutat hälytyksen kaikille sisäänkirjautuneille opereille), muuten
<pre>
/msg ChanServ register #kanava
/msg ChanServ flags #kanava !PPFI-Founders +*F
/msg ChanServ flags #kanava !piraatti-opit AOP
/msg ChanServ flags #kanava !piraattibotit VOP
/msg ChanServ flags #kanava $registered +A
/msg ChanServ flags #kanava Mikaela -*F
/msg ChanServ set #kanava antiflood on
/msg ChanServ set #kanava mlock +ngC-ilk
/mode #kanava -t
</pre>
# Rekisteröidään #kanava.
# Tehdään ryhmästä !PPFI-Founders kanavan omistaja (+F) ja annetaan kaikki muutkin oikeudet
# Tehdään rymästä !piraatti-opit oppeja.
# Annetaan ryhmälle !piraattibotit voice ja access-list oikeudet, +AV on sama asia.
# Annetaan sisäänkirjautuneille käyttäjille oikeus käyttää MemoServin <code>sendops</code> komentoa ja nähdä pääsylista.
# Poistetaan omat oikeudet (korvaa Mikaela tunnuksellasi), koska tarkoitus on käyttää jonkin ryhmän oikeuksia eikä joskus tulevaisuudessa ehkä poistaa jokaisesta ryhmästä erikseen lippuja.
# Asetetaan ChanServin tulvimisen esto päälle, se ei ole koskaan lauennut vahingossa huomatusti ja voice suojaa botteja siltä.
# Lukitaan kanavan tilan +ngC-ilk
## /msg #kanava kielto ellet ole kanavalla.
## kaikki saavat käyttää /inviteä olematta oppeja.
## /ctcp #kanava kielto (poikkeus: ACTION aka /me)
## invite-onlyn esto
## kanavan käyttäjärajan asettamisen esto
## kanavan salasanasuojauksen asettamisen esto (parempi tapa suojata kanava on esimerkiksi [[messi]]).
# Sallitaan kaikkien vaihtaa topiccia.
=== GroupServ ===
GroupServ sallii käyttäjien hallitsemisen ryhmänä. Esimerkiksi:
# Rekisteröidään ryhmä !piraatti-opit <code>/msg GroupServ register !piraatti-opit</code>
# Lisätään ryhmään NimiMerkki: <code>/msg GroupServ flags !piraatti-opit +cmvA</code>
#: c antaa pääsyn kanaville, joilla ryhmällä on pääsy, m lukemaan ryhmän MemoServ-viestejä, v ryhmän vhosteille (pyydä ryhmälle operilta (Scoffa & Mikaela tai #opers), A katsomaan keitä ryhmässä on.
# Tehdään !piraatti-opit #piraatit op: <code>/msg ChanServ flags #piraatit !piraatti-opit aop</code>
Kun !piraatti-opit annetaan lippuja kanavilla, kaikki ryhmän jäsenet joilla on c-lippu pääsevät käyttämään niitä. Kirjoitushetkellä !piraatti-opit kuuluu 20 jäsentä, jotkaovat 31 kanavan oppeja.
=== BotServ ===
BotServ sallii ChanServin customoimisen ja sinä puhumisen:
* Normaali ChanServ: [ChanServ] (ChanServ@services.pirateirc.net): Channel Services
* BotServ: [Blackbeard] (Edward@services.pirateirc.net): ChanServ Services bot
* <code>BOTLIST</code> antaa listan tarjolla olevista boteista
* <code>ASSIGN #KANAVA Blackbeard</code> korvaa ChanServin Blackbeardilla #kanavalla
* <code>UNASSIGN #KANAVA</code> palauttaa ChanServin
* <code>ACT #KANAVA katkoo päitä</code> saa botin tekemään /me katkoo päitä #kanavalla
* <code>SAY #KANAVA Ahoi</code> saa botin sanomaan #kanavalla Ahoi
=== ALIS ===
ALIS on päivitetty versio <code>/LIST-komennosta</code> sallien hakusanojen käytön.
Katso <code>/msg alis help list</code>
=== MemoServ ===
MemoServillä voi lähettää viestejä rekisteröityneille IRC-käyttäjlle, vaikkeivat he olisikaan verkossa.
Tärkeimmät komennot:
* <code>DELETE #NUMERO</code> poistaa viestin numero
* <code>SEND Mikaela Hei</code> lähettää Mikaelalle viestin "Hei"
* <code>READ NEW/NUMERO</code> näyttää uudet viestit tai viestin #numero.
* <code>SENDGROUP !RYHMÄ VIESTI</code>
* <code>SENDOPS #KANAVA VIESTI</code>
Viestit on myös mahdolista saada sähköpostitse <code>Muuttanut sivulle [[IRC/msg NickServ set emailmemos on</code>Palvelut]]
== Linkkejä ==
[[Luokka:IRC]]
[[Luokka:Ohjeet]]
[[Luokka:Pikaviestimet]]
