diff options
-rw-r--r-- | _config.yml | 2 | ||||
-rw-r--r-- | assets/css/style.css | 5 | ||||
-rw-r--r-- | development/index.markdown | 50 | ||||
-rw-r--r-- | development/index.textile | 38 | ||||
-rw-r--r-- | documentation/index.markdown | 7 | ||||
-rw-r--r-- | download/index.markdown | 148 | ||||
-rw-r--r-- | download/index.textile | 118 | ||||
-rw-r--r-- | test2.textile | 3 |
8 files changed, 211 insertions, 160 deletions
diff --git a/_config.yml b/_config.yml index ed05366..b647ca8 100644 --- a/_config.yml +++ b/_config.yml @@ -13,10 +13,12 @@ name: Irssi Core Team email: staff@irssi.org gems: + - jekyll-paginate - jekyll-redirect-from - jekyll-sitemap whitelist: + - jekyll-paginate - jekyll-redirect-from - jekyll-sitemap diff --git a/assets/css/style.css b/assets/css/style.css index d959fd3..75af93a 100644 --- a/assets/css/style.css +++ b/assets/css/style.css @@ -169,3 +169,8 @@ blockquote { .twitter-timeline { height: 80vh !important; } + +.osicon { + padding-right: 1ex; + margin-bottom: 1ex; +} diff --git a/development/index.markdown b/development/index.markdown new file mode 100644 index 0000000..9d964d1 --- /dev/null +++ b/development/index.markdown @@ -0,0 +1,50 @@ +--- +layout: page +title: Contributing +permalink: /development/ +--- + +# Irssi - Contributing + +### Development sources + +To get started with Irssi development, first check out the git repository: + + git clone https://github.com/irssi/irssi + +After check-out, you **must** run `./autogen.sh`. It may be necessary to install additional packages. More information can be found on [the wiki.][1]{:rel='external'} + +## Helping Development + +Hey you! Irssi is desperately looking for developers. No groundbreaking development has occured since ten years. Apart from fixing [bugs][2]{:rel='external'} and reviewing [patches][3]{:rel='external'}, there are also many huge issues which noone is tackling at the moment. Some of those are: + +* Rewrite the fe-text front-end to include vertical splits, flexible and multi-line status bars, vertical bars, zoom, layout pre-sets, dynamic themes, message tags, time-stamped messages, etc. +* Rewrite the core to optionally work in a distributed manner (where you can run the server connections on one server and connect to it with multiple fe-text front-ends) +* Revamp the API to better integrate multiple scripting languages (like Javascript, Lua) and require less (Perl-specific) glue code +* Fix and improve network Proxy support (SSL-enabled proxies, SSL connections over proxies, native SOCKS proxies in Irssi, better TOR support, per network proxies) ([#148][4]{:rel='external'}) +* Extend the IRC code to work better with any IRCv3 features. +* XMPP improvements +* Website improvements + +Also review the [Unofficial Roadmap][5]{:rel='external'} for a further source of TODOs. + +If you're lucky, you might find issues in the tracker that are [labeled 'easy'][6]{:rel='external'} + +### Scripts + +Perl scripts can be submitted to the [Irssi Script Repository][7]{:rel='external'} by following the instructions and sending a Pull Request on Github. Next to the perl and signals [documentation][8], the [Unofficial Irssi Scripting Documentation Wiki][9]{:rel='external'} may have additional helpful resources about writing scripts. + +### Themes + +Most of the existing documentation regarding themes can be found in the `default.theme` file created by Irssi when you `/save`, or `/save -formats`. Much of themeing is artistic skills combined with trial and error. Nice themes can be submitted to the [Irssi Themes Collection][10]{:rel='external'} through a Github Pull Request. + +[1]: https://github.com/shabble/irssi-docs/wiki/Irssi-0.8.17#compiling-from-git +[2]: //github.com/irssi/irssi/issues +[3]: //github/com/irssi/irssi/pulls +[4]: //github.com/irssi/irssi/pull/148 +[5]: //github.com/shabble/irssi-docs/wiki/Roadmap +[6]: //github.com/irssi/irssi/labels/easy +[7]: http://scripts.irssi.org/ +[8]: /documentation/ +[9]: //github.com/shabble/irssi-docs/wiki +[10]: //irssi-import.github.io/themes/ diff --git a/development/index.textile b/development/index.textile deleted file mode 100644 index 30b56ce..0000000 --- a/development/index.textile +++ /dev/null @@ -1,38 +0,0 @@ ---- -layout: page -title: Contributing -permalink: /development/ ---- - -h3. Development sources - -To get started with Irssi development, first check out the git repository: - -bc. git clone https://github.com/irssi/irssi - -After check-out, you *must* run @./autogen.sh@. It may be necessary to install additional packages. More information can be found on "(rel-external)the wiki.":https://github.com/shabble/irssi-docs/wiki/Irssi-0.8.17#compiling-from-git - -h2. Helping Development - -Hey you! Irssi is desperately looking for developers. No groundbreaking development has occured since ten years. Apart from fixing "(rel-external)bugs"://github.com/irssi/irssi/issues and reviewing "(rel-external)patches"://github/com/irssi/irssi/pulls, there are also many huge issues which noone is tackling at the moment. Some of those are: - -* Rewrite the fe-text front-end to include vertical splits, flexible and multi-line status bars, vertical bars, zoom, layout pre-sets, dynamic themes, message tags, time-stamped messages, etc. -* Rewrite the core to optionally work in a distributed manner (where you can run the server connections on one server and connect to it with multiple fe-text front-ends) -* Revamp the API to better integrate multiple scripting languages (like Javascript, Lua) and require less (Perl-specific) glue code -* Fix and improve network Proxy support (SSL-enabled proxies, SSL connections over proxies, native SOCKS proxies in Irssi, better TOR support, per network proxies) ("#148"://github.com/irssi/irssi/pull/148) -* Extend the IRC code to work better with any IRCv3 features. -* XMPP improvements -* Website improvements - -Also review the "(rel-external)Unofficial Roadmap"://github.com/shabble/irssi-docs/wiki/Roadmap for a further source of TODOs. - -If you're lucky, you might find issues in the tracker that are "(rel-external)labeled 'easy'"://github.com/irssi/irssi/labels/easy - -h3. Scripts - -Perl scripts can be submitted to the "(rel-external)Irssi Script Repository":http://scripts.irssi.org/ by following the instructions and sending a Pull Request on Github. Next to the perl and signals "documentation":/documentation/, the "(rel-external)Unofficial Irssi Scripting Documentation Wiki"://github.com/shabble/irssi-docs/wiki may have additional helpful resources about writing scripts. - -h3. Themes - -Most of the existing documentation regarding themes can be found in the @default.theme@ file created by Irssi when you @/save@, or @/save -formats@. Much of themeing is artistic skills combined with trial and error. Nice themes can be submitted to the "(rel-external)Irssi Themes Collection"://irssi-import.github.io/themes/ through a Github Pull Request. - diff --git a/documentation/index.markdown b/documentation/index.markdown index e97952e..539f72c 100644 --- a/documentation/index.markdown +++ b/documentation/index.markdown @@ -4,9 +4,11 @@ title: Documentation permalink: documentation/ categories: [ _nav ] --- + ## Irssi documentation and tutorials: -###Documentation +### Documentation + - Check the built-in `/HELP`, it has all the details on command syntax - [Startup How-To](startup) - [Settings](settings) @@ -17,6 +19,7 @@ categories: [ _nav ] - [Contributing](/development) ### Miscellaneous + - [Tips & Tricks](tips) - [Irssi Proxy](//github.com/irssi/irssi/blob/master/docs/proxy.txt){:rel='external'}, the mini-bnc module - [Colour Formats](//github.com/irssi/irssi/blob/master/docs/formats.txt){:rel='external'} @@ -24,12 +27,14 @@ categories: [ _nav ] - [Irssi 0.8.17 Tips](//github.com/shabble/irssi-docs/wiki/Irssi-0.8.17){:rel='external'} ### Tutorials + - [General guide to Irssi and GNU screen](//quadpoint.org/articles/irssi/){:rel='external'} - [Split windows handling](//quadpoint.org/articles/irssisplit/){:rel='external'} - [Split windows handling Addendum](http://wouter.coekaerts.be/irssi/split){:rel='external'} - [Showing events in different windows](http://wouter.coekaerts.be/site/irssi/wclf){:rel='external'} ### Scripting + - [Scripting Tutorial](http://juerd.nl/site.plp/irssiscripttut){:rel='external'}, by Juerd - [Perl Scripting Reference](//github.com/irssi/irssi/blob/master/docs/perl.txt){:rel='external'} - [Signals](//github.com/irssi/irssi/blob/master/docs/signals.txt){:rel='external'} diff --git a/download/index.markdown b/download/index.markdown new file mode 100644 index 0000000..5011179 --- /dev/null +++ b/download/index.markdown @@ -0,0 +1,148 @@ +--- +layout: page +title: Getting Irssi +permalink: /download/ +categories: [ _nav, _6 ] +--- + +There are several ways you can get Irssi: + +0. [Ready-Made Packages](#distributions-packages) +0. [Compiling from Sources](#sources) + +## Distributions' Packages + +<div class="row"> +<div class="col-md-4" markdown="1"> + +![][1]{:class='osicon'}**Windows** + +Download setup.exe from [Cygwin][2]{:rel='external'} and select irssi during the package selection step. To start irssi, open MinTTY (link should be on your Desktop) and type `irssi` + +[1]: /assets/Windows.png +[2]: https://www.cygwin.com/ + +</div> +<div class="col-md-4" markdown="1"> + +![][3]{:class='osicon'}![][4]{:class='osicon'}**Debian/Ubuntu** + +`apt-get install irssi`. +You may find more up to date version on [Debian Backports][5]{:rel='external'} + +[3]: /assets/debian.png +[4]: /assets/ubuntu.png +[5]: http://backports.debian.org/ + +</div> +<div class="col-md-4" markdown="1"> + +![][6]{:class='osicon'}**OS X** + +Install [Homebrew][7]{:rel='external'}, then +`brew install irssi` +You can also install Git with `--HEAD` + +[6]: /assets/macosx.png +[7]: http://brew.sh/ + +</div> +</div> +<div class="row"> +<div class="col-md-4" markdown="1"> + +![][8]{:class='osicon'}**Gentoo** + +`emerge irssi` + +[8]: /assets/gentoo.png + +</div> +<div class="col-md-4" markdown="1"> + +![][19]{:class='osicon'}**SuSE** + +`zypper in irssi`. + +You may find more up to date versions on [openSUSE Package Search][20]{:rel='external'} + +[19]: /assets/openSUSE.png +[20]: http://software.opensuse.org/package/irssi + +</div> +<div class="col-md-4" markdown="1"> + +![][9]{:class='osicon'}**ArchLinux** + +`pacman -S irssi` + +[9]: /assets/arch.png + +</div> +</div> +<div class="row"> +<div class="col-md-4" markdown="1"> + +![][10]{:class='osicon'}**Fedora/Red Hat** + +`dnf install irssi` or +`yum install irssi` + +[10]: /assets/fedora.png + +</div> +<div class="col-md-4" markdown="1"> + +![][11]{:class='osicon'}**Solaris** + +`pkg-get install irssi` + +[11]: /assets/opencsw.png + +</div> +<div class="col-md-4" markdown="1"> + +![][12]{:class='osicon'}**Slackware** + +`slackpkg install irssi` + +[12]: /assets/slackware.png + +</div> +</div> + +## Sources + +Latest release version: **0.8.17** – [Downloads][13]{:rel='external'} + +Latest pre-release version: **0.8.18-beta2** – [Downloads][14]{:rel='external'} + +See the included [INSTALL][15]{:rel='external'} file for building instructions + +To verify the signatures: + + gpg --keyserver wwwkeys.pgp.net --recv-keys DDBEF0E1 + +You shouldn't really trust this key without verifying its fingerprint. See it with `gpg --fingerprint staff@irssi.org` and ask someone if it matches (eg. on `#irssi`). + + gpg --verify irssi-0.8.17.tar.gz.asc + +(This key is different from the one used to sign binaries of versions before 0.8.10. More gpg help can be found from GPG manual) + +### Development sources + +[Git][16]{:rel='external'} – You can also get the development version. To check it out, run + + git clone https://github.com/irssi/irssi + +After check-out, you **must** run `./autogen.sh`. It may be necessary to install additional packages. More information can be found on [the wiki.][17]{:rel='external'} + +See also: [Commit Log][18]{:rel='external'} + +[13]: //github.com/irssi-import/irssi/releases +[14]: //github.com/irssi/irssi/releases +[15]: //github.com/irssi/irssi/blob/master/INSTALL +[16]: //github.com/irssi/irssi +[17]: //github.com/shabble/irssi-docs/wiki/Irssi-0.8.17#compiling-from-git +[18]: //github.com/irssi/irssi/commits/master + diff --git a/download/index.textile b/download/index.textile deleted file mode 100644 index 0a6da83..0000000 --- a/download/index.textile +++ /dev/null @@ -1,118 +0,0 @@ ---- -layout: page -title: Getting Irssi -permalink: /download/ -categories: [ _nav, _6 ] ---- -There are several ways you can get Irssi: - -# "Ready-Made Packages":#packages -# "Compiling from Sources":#sources - -h2(#packages). Distributions' Packages - -<div class="row"> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/Windows.png!*Windows* - -p. Download setup.exe from "(rel-external)Cygwin":https://www.cygwin.com/ and select irssi during the package selection step. To start irssi, open MinTTY (link should be on your Desktop) and type @irssi@ - -</div> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !/assets/debian.png!!{padding-right:1ex}/assets/ubuntu.png!*Debian/Ubuntu* - -@apt-get install irssi@. -You may find more up to date version on "(rel-external)Debian Backports":http://backports.debian.org/ - -</div> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/macosx.png!*OS X* - -Install "(rel-external)Homebrew":http://brew.sh/, then -@brew install irssi@ -You can also install Git with @--HEAD@ - -</div> -</div> -<div class="row"> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/gentoo.png!*Gentoo* - -@emerge irssi@ - -</div> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/openSUSE.png!*SuSE* - -@zypper in irssi@. -You may find more up to date versions on "(rel-external)openSUSE Package Search":http://software.opensuse.org/package/irssi - -</div> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/arch.png!*ArchLinux* - -@pacman -S irssi@ - -</div> -</div> -<div class="row"> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/fedora.png!*Fedora/Red Hat* - -@dnf install irssi@ or -@yum install irssi@ - -</div> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/opencsw.png!*Solaris* - -@pkg-get install irssi@ - -</div> -<div class="col-md-4"> - -div{margin-bottom:1ex}. !{padding-right:1ex}/assets/slackware.png!*Slackware* - -@slackpkg install irssi@ - -</div> -</div> - -h2(#sources). Sources - -Latest release version: *0.8.17* - "(rel-external)Downloads"://github.com/irssi-import/irssi/releases - -Latest pre-release version: *0.8.18-beta2* - "(rel-external)Downloads"://github.com/irssi/irssi/releases - -See the included "(rel-external)INSTALL"://github.com/irssi/irssi/blob/master/INSTALL file for building instructions - -To verify the signatures: - -bc. gpg --keyserver wwwkeys.pgp.net --recv-keys DDBEF0E1 - -You shouldn't really trust this key without verifying its fingerprint. See it with [@gpg --fingerprint staff@irssi.org@] and ask someone if it matches (eg. on @#irssi@). - -bc. gpg --verify irssi-0.8.17.tar.gz.asc - -(This key is different from the one used to sign binaries of versions before 0.8.10. More gpg help can be found from GPG manual) - -h3. Development sources - -"(rel-external)Git":1 - You can also get the development version. To check it out, run - -bc. git clone https://github.com/irssi/irssi - -After check-out, you *must* run @./autogen.sh@. It may be necessary to install additional packages. More information can be found on "(rel-external)the wiki.":https://github.com/shabble/irssi-docs/wiki/Irssi-0.8.17#compiling-from-git - -See also: "(rel-external)Commit Log"://github.com/irssi/irssi/commits/master - - -[1]https://github.com/irssi/irssi diff --git a/test2.textile b/test2.textile deleted file mode 100644 index 0d6905d..0000000 --- a/test2.textile +++ /dev/null @@ -1,3 +0,0 @@ ---- -layout: default ---- |