https://github.com/petermarkley/tollerus
A conlang dictionary Laravel package - the luxurious way to build, track, and browse your conlang's lexical data
https://github.com/petermarkley/tollerus
authoring conlang conlanging dictionary-software dictionary-tools languages laravel laravel-package lexicography neography
Last synced: 3 months ago
JSON representation
A conlang dictionary Laravel package - the luxurious way to build, track, and browse your conlang's lexical data
- Host: GitHub
- URL: https://github.com/petermarkley/tollerus
- Owner: petermarkley
- License: lgpl-2.1
- Created: 2023-03-01T05:46:34.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-03-06T06:54:01.000Z (3 months ago)
- Last Synced: 2026-03-06T07:16:48.134Z (3 months ago)
- Topics: authoring, conlang, conlanging, dictionary-software, dictionary-tools, languages, laravel, laravel-package, lexicography, neography
- Language: PHP
- Homepage:
- Size: 3 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
_A conlang dictionary Laravel package - the luxurious way to build, track, and browse your conlang's lexical data_
I'm a one-man dev team. If you like this software, please consider [supporting me](https://paypal.me/petermarkley)!
> [!Note]
> Made for use on [https://eithalica.world](https://eithalica.world/lore/dictionary/?lang=chetnum). Named after good ol' "Tollers," the 20th-century conlanger legend.
# Installation
## 1. Create Laravel app
If you don't already have one, you will need to [create a Laravel app](https://laravel.com/docs/12.x/installation#creating-a-laravel-project).
```
laravel new example-app
cd example-app
```
Make sure to edit the `.env` file as needed, for example to give Laravel database access.
## 2. Install Tollerus
### From Packagist
```
composer require petermarkley/tollerus
```
### From GitHub
```
composer config repositories.tollerus vcs https://github.com/petermarkley/tollerus.git
composer require petermarkley/tollerus:dev-main
```
## 3. Copy Tollerus files
This will copy to your host app some files that Tollerus needs to run:
```
php artisan tollerus:install
```
> [!Tip]
> After you run this, take a look inside `config/tollerus.php` for any options that you want to change--especially database options that may be difficult to change later on!
## 4. Database migration
Tollerus also needs to create some database tables:
```
php artisan migrate
```
## 5. All done!
You can now start your web server and visit `/tollerus/admin` in your host app (or whatever your `admin_route_prefix` config key is set to), and start conlanging!
## Troubleshooting
Tollerus assumes you want only logged-in users to access admin pages. If you get a `Route [login] not defined` error, that means there's no login page, and therefore no way for a user to log in.
(If you hit a `Base table or view not found: 1146 Table 'sessions' doesn't exist` error, that means you haven't run a migration and there's no database table for Laravel to even check if the current user is logged in or not.)
If you don't mind your admin interface being exposed to unauthenticated users, you can find this config key in `config/tollerus.php`:
```
'admin_middleware' => ['web','auth'],
```
and remove the `auth` middleware:
```
'admin_middleware' => ['web'],
```
> [!Caution]
> Removing `auth` from admin routes is not recommended in a production environment or anywhere that's accessible to the open web.