From 7be28cbd4b7c094cf05accb5b85c0746e88181ad Mon Sep 17 00:00:00 2001 From: Patrick Spek Date: Sat, 14 Jul 2018 13:52:31 +0200 Subject: Update project index and allow project descriptions --- _config.yml | 2 +- _layouts/project.html | 22 ++++++++++++++++++ _pages/projects.md | 16 ++++++++++--- _projects/assixt.md | 54 +++++++++++++++++++++++++++++++++++++++++++ _projects/lonestar.adoc | 48 ++++++++++++++++++++++++++++++++++++++ _projects/perl6-app-assixt.md | 6 ----- css/main.less | 6 +++++ 7 files changed, 144 insertions(+), 10 deletions(-) create mode 100644 _layouts/project.html create mode 100644 _projects/assixt.md create mode 100644 _projects/lonestar.adoc delete mode 100644 _projects/perl6-app-assixt.md diff --git a/_config.yml b/_config.yml index 0d30703..8668cbd 100644 --- a/_config.yml +++ b/_config.yml @@ -41,7 +41,7 @@ include: ["_pages"] # custom collections collections: projects: - output: false + output: true slides: output: false diff --git a/_layouts/project.html b/_layouts/project.html new file mode 100644 index 0000000..e85b209 --- /dev/null +++ b/_layouts/project.html @@ -0,0 +1,22 @@ +--- +layout: default +--- + +
+
+

{{ page.title }}

+
+
+ {{ content }} +
+
+
+
    +
  • Language(s): {{ page.langs }}
    • +
  • License: {{ page.license }}
    • +
  • + Source repository: {{ page.repo }} +
    • +
+
+
diff --git a/_pages/projects.md b/_pages/projects.md index 08293c3..021cc36 100644 --- a/_pages/projects.md +++ b/_pages/projects.md @@ -9,6 +9,7 @@ description: > --- # Projects + Here is a list of all projects I worked on that I deem good or important enough to publish here. This list won't always be complete, but you can check my profiles on [Github][github] or [GitLab][gitlab] if you're interested to see @@ -21,22 +22,31 @@ support][support]. You can also come discuss the projects and possible issues you have found with them on IRC or contact me through email. Details for both can be found [on the homepage][home]. +Some projects have extended descriptions available. You can reach these by +clicking their respective links. You can read some background information on +why I decided to start out with the project, and how to make use of it yourself +as well. + - {% for project in site.projects %} - + - {% endfor %} diff --git a/_projects/assixt.md b/_projects/assixt.md new file mode 100644 index 0000000..dc82474 --- /dev/null +++ b/_projects/assixt.md @@ -0,0 +1,54 @@ +--- +layout: project +title: Assixt +langs: Perl 6 +license: GPLv3 +repo: https://gitlab.com/tyil/perl6-app-assixt +--- + +`assixt`, or `App::Assixt`, is a Perl 6 module which I wrote in order to make +it easier to write more Perl 6 modules. I also used it as a good project to get +better with Perl 6 with. Nowadays, it's doing much more than I anticipated at +the start of the project. I've turned it into a more complete solution for Perl +6 projects in general. + +`assixt` can create new Perl 6 module skeletons, complete with `.gitignore`, +basic CHANGELOG, Travis and GitLab CI configurations and more. It will also +keep version numbers used accross your project in sync, create correct +distribution tarballs and allows you to upload them to [CPAN][cpan] directly +from the command line. + +I've given a presentation on this project at the 14th Dutch Perl Workshop, and +the slides are available [on the Slides section of my site][slides] as well. + +## Installation + +To install `assixt`, you will need to have Perl 6 installed, and `zef` +available as well. I recommend you use [Rakudo Star][rakudo] releases for +these. If you're using GNU+Linux, you might want to take a look at +[LoneStar][lonestar]. This is a Bash program that will fetch, unpack and +compile Rakudo Star Perl 6 for you, including `zef` and a number of other +common modules. + +If you have Perl 6 installed, simply invoke `zef` to install the module +containing `assixt`: + +```sh +zef install App::Assixt +``` + +## Support and feedback + +Check out `assixt --help` for an overview of what you can do with it. You can +also check the README on the repository to get a more extensive overview of the +possibilities, and some examples on how to use it. + +You can also create issues on the repository if you are still having trouble, +or perhaps even found a bug. The `#perl6` channel on Freenode might also be of +assistance, as I am almost always available in that channel (so long as I'm +awake). You can report feedback through issues or IRC as well. + +[cpan]: https://www.cpan.org/ +[slides]: /slides/ +[lonestar]: /projects/lonestar/ +[rakudo]: https://rakudo.org/ diff --git a/_projects/lonestar.adoc b/_projects/lonestar.adoc new file mode 100644 index 0000000..0925cf5 --- /dev/null +++ b/_projects/lonestar.adoc @@ -0,0 +1,48 @@ +--- +layout: project +title: LoneStar +langs: Bash +license: AGPLv3 +repo: https://gitlab.com/tyil/lonestar +--- + +LoneStar is a simple program, written in Bash, to download and install +https://rakudo.org[Rakudo Star Perl 6]. As of the moment of writing this +program, Rakudo Star Perl 6 binaries cannot easily be moved around on the OS, +making regular installation methods more troublesome than they ought to be. To +deal with the installation issue, I wrote LoneStar, to just take care of it. I +chose to use Bash to ensure it can run on a wide range of GNU+Linux systems +without much trouble. + +== Installation + +LoneStar is given a `Makefile` which can take care of installation. However, it +does not _need_ to be installed if you just want to try it out first. I would +recommend installation anyway, in order to make easy use of the `init` +subcommand (which will update you `$PATH` to include the Perl 6 executables for +you). + +You can clone the repo using git, and use `make` to install it: + +[source,sh] +---- +cd "$(mktemp -d)" +git clone https://gitlab.com/tyil/lonestar . +make DESTDIR=/usr/local install +---- + +Some shells will require you to _rehash the $PATH_. On Bash, this is done +using `hash -r`. Zsh users should run `rehash`. Other shell users may have to +consult their respective shell's manual. With newer shells, this is oftentimes +not necessary, though. + +== Usage + +You can invoke `lonestar` without any parameters to get a list of subcommands +it will accept, together with optional parameters. To just get the latest +Rakudo Star Perl 6 distribution installed, run `lonestar install`. + +== Issues and feedback + +Issues and feedback can be left on the repository, or you can contact me +directly via any of the channels listed on the homepage of my blog. diff --git a/_projects/perl6-app-assixt.md b/_projects/perl6-app-assixt.md deleted file mode 100644 index e8e2868..0000000 --- a/_projects/perl6-app-assixt.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: App::Assixt -langs: Perl 6 -license: GPLv3 -repo: https://github.com/scriptkitties/perl6-app-assixt ---- diff --git a/css/main.less b/css/main.less index 523cbfc..199ef30 100644 --- a/css/main.less +++ b/css/main.less @@ -137,6 +137,12 @@ p.text-center { text-align: center; } +article { + footer hr { + width: 50% + } +} + @media screen and (max-width: 500px) { body{ text-align: left; -- cgit v1.1
Project Language(s) LicenseRepository
{{ project.title }} + {% if project.content != "" %} + {{ project.title }} + {% else %} + {{ project.title }} + {% endif %} + {{ project.langs }} {{ project.license }}{{ project.repo }}