summaryrefslogtreecommitdiff
path: root/_projects
diff options
context:
space:
mode:
authorPatrick Spek <p.spek@tyil.nl>2018-07-14 13:52:31 +0200
committerPatrick Spek <p.spek@tyil.nl>2018-07-14 13:52:31 +0200
commit7be28cbd4b7c094cf05accb5b85c0746e88181ad (patch)
tree1f6233069463c627b404b99bcf1d294da4169e18 /_projects
parent2cf753e4a8d0bb620ba09e5ac35bc1d3f16ad348 (diff)
Update project index and allow project descriptions
Diffstat (limited to '_projects')
-rw-r--r--_projects/assixt.md54
-rw-r--r--_projects/lonestar.adoc48
-rw-r--r--_projects/perl6-app-assixt.md6
3 files changed, 102 insertions, 6 deletions
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
----