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 --- _projects/assixt.md | 54 +++++++++++++++++++++++++++++++++++++++++++ _projects/lonestar.adoc | 48 ++++++++++++++++++++++++++++++++++++++ _projects/perl6-app-assixt.md | 6 ----- 3 files changed, 102 insertions(+), 6 deletions(-) create mode 100644 _projects/assixt.md create mode 100644 _projects/lonestar.adoc delete mode 100644 _projects/perl6-app-assixt.md (limited to '_projects') 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 ---- -- cgit v1.1