Skip to content

Commit

Permalink
feat: added markdown support
Browse files Browse the repository at this point in the history
Signed-off-by: Lukas Frey <[email protected]>
  • Loading branch information
lukas-frey committed Apr 28, 2024
1 parent 8c397e4 commit fa38e8b
Show file tree
Hide file tree
Showing 40 changed files with 6,806 additions and 444 deletions.
6 changes: 3 additions & 3 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
blank_issues_enabled: false
contact_links:
- name: Ask a question
url: https://github.com/:vendor_name/:package_name/discussions/new?category=q-a
url: https://github.com/Guava/filament-knowledge-base/discussions/new?category=q-a
about: Ask the community for help
- name: Request a feature
url: https://github.com/:vendor_name/:package_name/discussions/new?category=ideas
url: https://github.com/Guava/filament-knowledge-base/discussions/new?category=ideas
about: Share ideas for new features
- name: Report a security issue
url: https://github.com/:vendor_name/:package_name/security/policy
url: https://github.com/Guava/filament-knowledge-base/security/policy
about: Learn how to notify us for sensitive bugs
12 changes: 0 additions & 12 deletions .github/dependabot.yml

This file was deleted.

32 changes: 0 additions & 32 deletions .github/workflows/dependabot-auto-merge.yml

This file was deleted.

31 changes: 0 additions & 31 deletions .github/workflows/update-changelog.yml

This file was deleted.

2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# Changelog

All notable changes to `:package_name` will be documented in this file.
All notable changes to `filament-knowledge-base` will be documented in this file.
2 changes: 1 addition & 1 deletion LICENSE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
The MIT License (MIT)

Copyright (c) :vendor_name <[email protected]>
Copyright (c) Guava <[email protected]>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
36 changes: 14 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,13 @@
![:package_name Banner](docs/images/banner.jpg)
![filament-knowledge-base Banner](docs/images/banner.jpg)


# :package_description
# A filament plugin that adds a knowledge base and help to your filament panel(s).

[![Latest Version on Packagist](https://img.shields.io/packagist/v/:vendor_slug/:package_slug.svg?style=flat-square)](https://packagist.org/packages/:vendor_slug/:package_slug)
[![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/:vendor_slug/:package_slug/run-tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/:vendor_slug/:package_slug/actions?query=workflow%3Arun-tests+branch%3Amain)
[![GitHub Code Style Action Status](https://img.shields.io/github/actions/workflow/status/:vendor_slug/:package_slug/fix-php-code-style-issues.yml?branch=main&label=code%20style&style=flat-square)](https://github.com/:vendor_slug/:package_slug/actions?query=workflow%3A"Fix+PHP+code+style+issues"+branch%3Amain)
[![Total Downloads](https://img.shields.io/packagist/dt/:vendor_slug/:package_slug.svg?style=flat-square)](https://packagist.org/packages/:vendor_slug/:package_slug)
<!--delete-->
---
This repo can be used to scaffold a Laravel package. Follow these steps to get started:
[![Latest Version on Packagist](https://img.shields.io/packagist/v/guava/filament-knowledge-base.svg?style=flat-square)](https://packagist.org/packages/guava/filament-knowledge-base)
[![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/guava/filament-knowledge-base/run-tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/guava/filament-knowledge-base/actions?query=workflow%3Arun-tests+branch%3Amain)
[![GitHub Code Style Action Status](https://img.shields.io/github/actions/workflow/status/guava/filament-knowledge-base/fix-php-code-style-issues.yml?branch=main&label=code%20style&style=flat-square)](https://github.com/guava/filament-knowledge-base/actions?query=workflow%3A"Fix+PHP+code+style+issues"+branch%3Amain)
[![Total Downloads](https://img.shields.io/packagist/dt/guava/filament-knowledge-base.svg?style=flat-square)](https://packagist.org/packages/guava/filament-knowledge-base)

1. Press the "Use this template" button at the top of this repo to create a new repo with the contents of this skeleton.
2. Run "php ./configure.php" to run a script that will replace all placeholders throughout all the files.
3. Have fun creating your package.
---
<!--/delete-->
This is where your description should go. Limit it to a paragraph or two. Consider adding a small example.

## Showcase
Expand All @@ -33,20 +25,20 @@ While our plugin is available for all to use, if you are utilizing it for commer
You can install the package via composer:

```bash
composer require :vendor_slug/:package_slug
composer require guava/filament-knowledge-base
```

You can publish and run the migrations with:

```bash
php artisan vendor:publish --tag=":package_slug-migrations"
php artisan vendor:publish --tag="filament-knowledge-base-migrations"
php artisan migrate
```

You can publish the config file with:

```bash
php artisan vendor:publish --tag=":package_slug-config"
php artisan vendor:publish --tag="filament-knowledge-base-config"
```

This is the contents of the published config file:
Expand All @@ -59,14 +51,14 @@ return [
Optionally, you can publish the views using

```bash
php artisan vendor:publish --tag=":package_slug-views"
php artisan vendor:publish --tag="filament-knowledge-base-views"
```

## Usage

```php
$variable = new VendorName\Skeleton();
echo $variable->echoPhrase('Hello, VendorName!');
$filamentKnowledgeBase = new Guava\FilamentKnowledgeBase();
echo $filamentKnowledgeBase->echoPhrase('Hello, Guava!');
```

## Testing
Expand All @@ -89,9 +81,9 @@ Please review [our security policy](../../security/policy) on how to report secu

## Credits

- [:author_name](https://github.com/:author_username)
- [Lukas Frey](https://github.com/GuavaCZ)
- [All Contributors](../../contributors)
- Spatie - Our package skeleton is a modified version of [Spatie's Package Skeleton](https://github.com/spatie/package-skeleton-laravel)
- Spatie - Our package filament-knowledge-base is a modified version of [Spatie's Package FilamentKnowledgeBase](https://github.com/spatie/package-filament-knowledge-base-laravel)

## License

Expand Down
39 changes: 23 additions & 16 deletions composer.json
Original file line number Diff line number Diff line change
@@ -1,24 +1,29 @@
{
"name": ":vendor_slug/:package_slug",
"description": ":package_description",
"name": "guava/filament-knowledge-base",
"description": "A filament plugin that adds a knowledge base and help to your filament panel(s).",
"keywords": [
":vendor_name",
"Guava",
"laravel",
":package_slug"
"filament-knowledge-base"
],
"homepage": "https://github.com/:vendor_slug/:package_slug",
"homepage": "https://github.com/guava/filament-knowledge-base",
"license": "MIT",
"authors": [
{
"name": ":author_name",
"email": "[email protected]",
"name": "Lukas Frey",
"email": "[email protected]",
"role": "Developer"
}
],
"require": {
"php": "^8.1",
"filament/filament": "^3.2",
"illuminate/contracts": "^10.0|^11.0",
"league/commonmark": "^2.4",
"spatie/laravel-markdown": "^2.5",
"spatie/laravel-package-tools": "^1.14.0",
"illuminate/contracts": "^10.0"
"spatie/php-structure-discoverer": "^2.1",
"symfony/yaml": "^6.4"
},
"require-dev": {
"laravel/pint": "^1.0",
Expand All @@ -30,24 +35,26 @@
"pestphp/pest-plugin-laravel": "^2.0",
"phpstan/extension-installer": "^1.1",
"phpstan/phpstan-deprecation-rules": "^1.0",
"phpstan/phpstan-phpunit": "^1.0",
"spatie/laravel-ray": "^1.26"
"phpstan/phpstan-phpunit": "^1.0"
},
"autoload": {
"files": [
"src/helpers.php"
],
"psr-4": {
"VendorName\\Skeleton\\": "src/",
"VendorName\\Skeleton\\Database\\Factories\\": "database/factories/"
"Guava\\FilamentKnowledgeBase\\": "src/",
"Guava\\FilamentKnowledgeBase\\Database\\Factories\\": "database/factories/"
}
},
"autoload-dev": {
"psr-4": {
"VendorName\\Skeleton\\Tests\\": "tests/",
"Guava\\FilamentKnowledgeBase\\Tests\\": "tests/",
"Workbench\\App\\": "workbench/app/"
}
},
"scripts": {
"post-autoload-dump": "@composer run prepare",
"clear": "@php vendor/bin/testbench package:purge-skeleton --ansi",
"clear": "@php vendor/bin/testbench package:purge-filament-knowledge-base --ansi",
"prepare": "@php vendor/bin/testbench package:discover --ansi",
"build": [
"@composer run prepare",
Expand All @@ -73,10 +80,10 @@
"extra": {
"laravel": {
"providers": [
"VendorName\\Skeleton\\SkeletonServiceProvider"
"Guava\\FilamentKnowledgeBase\\FilamentKnowledgeBaseServiceProvider"
],
"aliases": {
"Skeleton": "VendorName\\Skeleton\\Facades\\Skeleton"
"FilamentKnowledgeBase": "Guava\\FilamentKnowledgeBase\\Facades\\FilamentKnowledgeBase"
}
}
},
Expand Down
9 changes: 9 additions & 0 deletions config/filament-knowledge-base.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<?php

// config for Guava/FilamentKnowledgeBase
return [
'id' => env('FILAMENT_KB_ID', 'knowledge-base'),
'path' => env('FILAMENT_KB_PATH', 'kb'),
'guest-access' => env('FILAMENT_KB_GUEST_ACCESS', true),
'theme-path' => 'resources/css/filament/admin/theme.css',
];
6 changes: 0 additions & 6 deletions config/skeleton.php

This file was deleted.

Loading

0 comments on commit fa38e8b

Please sign in to comment.