@sveltia/cms 0.4.1 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +22 -20
  2. package/dist/sveltia-cms.js +123 -123
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Sveltia CMS
2
2
 
3
- Sveltia CMS is a Git-based lightweight headless CMS partially compatible with [Netlify/Decap CMS](https://decapcms.org/). You can use it with any static site generator, such as SvelteKit, Next.js and Hugo, to manage the content as static files on a Git repository. Our open source Netlify/Decap CMS alternative is now in public beta, with more features to come.
3
+ Sveltia CMS is a Git-based lightweight headless CMS partially compatible with [Netlify/Decap CMS](https://decapcms.org/). You can use it with any static site generator, such as SvelteKit, Eleventy, Next.js and Hugo, to manage the content as static files on a Git repository. The open source Netlify/Decap CMS alternative is now in public beta, with more features to come.
4
4
 
5
5
  ![Screenshot: Git-based Headless CMS with Dark Mode](docs/screenshot-1.jpg)<br>
6
6
 
@@ -26,7 +26,7 @@ Here are some highlights mainly compared to Netlify/Decap CMS:
26
26
 
27
27
  - Ready to replace Netlify/Decap CMS _in some casual use case scenarios_ by updating one single line of code.
28
28
  - Existing [configuration files](https://decapcms.org/docs/configuration-options/) can be reused as is.
29
- - Many features are still missing though; [see the chart below](#compatibility) for details.
29
+ - Various features are still missing though; [see the chart below](#compatibility) for details.
30
30
 
31
31
  ### Better UX
32
32
 
@@ -42,28 +42,31 @@ Here are some highlights mainly compared to Netlify/Decap CMS:
42
42
 
43
43
  ### Better productivity
44
44
 
45
+ - Required fields, not optional fields, are clearly marked for efficient data entry.
45
46
  - Integrating Pexels, Pixabay and Unsplash to allow inserting free stock photos into image fields with no hassle[^8].
46
- - Able to work on a local Git repository without having to run a proxy server. [See below](#work-with-a-local-git-repository) for details.
47
- - Able to delete multiple entries and assets at once.
47
+ - You can [work on a local Git repository](#work-with-a-local-git-repository) without having to run a proxy server.
48
+ - Delete multiple entries and assets at once.
48
49
  - Solving various outstanding Netlify/Decap CMS bugs[^11].
49
50
 
50
51
  ### Better i18n support
51
52
 
52
53
  - Making it easier to switch between locales while editing with just a click on a button.
53
- - Integrating DeepL to allow translating text fields from another locale with one click. [See below](#use-deepl-to-translate-entry-fields) for details.
54
- - You can now use a random UUID for an entry slug, which is a good option for locales writing in non-Latin characters[^12]. [See below](#use-a-random-id-for-an-entry-slug) for details.
54
+ - [Integrating DeepL](#use-deepl-to-translate-entry-fields) to allow translating text fields from another locale with one click.
55
+ - You can now [use a random UUID for an entry slug](#use-a-random-id-for-an-entry-slug), which is a good option for locales writing in non-Latin characters[^12].
55
56
  - Solving limitations in Netlify/Decap CMS’s [list and object widgets](https://decapcms.org/docs/beta-features/#i18n-support) so that changes made with these widgets will be duplicated between locales as expected[^7].
56
57
  - Users can now choose their preferred UI locale.
57
58
 
58
59
  ### Collection enhancements
59
60
 
60
- - You can choose a custom icon for each collection[^3]. [See below](#use-a-custom-icon-for-a-collection) for details.
61
- - A per-collection media folder will now appear aside of entries. [See below](#use-a-custom-media-folder-for-a-collection) for details.
61
+ - You can choose a [custom icon for each collection](#use-a-custom-icon-for-a-collection)[^3].
62
+ - A [per-collection media folder](#use-a-custom-media-folder-for-a-collection) will now appear aside of entries.
62
63
 
63
64
  ### Media library enhancements
64
65
 
65
- - A whole new media library makes it easier to manage all your assets.
66
- - You can upload multiple assets at once, including files in nested folders, by browsing or dragging & dropping them into the media library[^5].
66
+ - An all-new media library makes it easy to manage all your assets.
67
+ - Sort or filter assets by name or file type.
68
+ - View asset details, including size, dimensions, and a list of entries that use the selected asset.
69
+ - Upload multiple assets at once, including files in nested folders, by browsing or dragging & dropping them into the media library[^5].
67
70
  - You can now navigate between the global media folder and a per-collection media folder[^6].
68
71
 
69
72
  ## Compatibility
@@ -73,7 +76,7 @@ While recreating all the features found in Netlify/Decap CMS is not our goal, we
73
76
  | Feature | Status in Sveltia CMS |
74
77
  | --- | --- |
75
78
  | UI locales | Only English and Japanese are available at this time. No registration is needed. While the UI locale is automatically selected depending on the browser’s language settings, it can be changed in Preferences. (Click on the Account button at the top right corner of the CMS.) |
76
- | Account | Only the [GitHub backend](https://decapcms.org/docs/github-backend/) is available at this time. You can keep using Netlify or a [3rd party OAuth client](https://decapcms.org/docs/external-oauth-clients/) (or [our own client](https://github.com/sveltia/sveltia-cms-auth)) to sign in with GitHub, just like Netlify/Decap CMS. GitLab could also be supported, but the Azure, Bitbucket and Git Gateway backends are unlikely to be added, mainly due to the lack of an API method fetching contents in bulk. We plan to add support for the [Test backend](https://decapcms.org/docs/test-backend/) for our demo site and perhaps implement a performant Git Gateway alternative using GraphQL. |
79
+ | Account | Only the [GitHub backend](https://decapcms.org/docs/github-backend/) is available at this time. You can keep using Netlify or a [3rd party OAuth client](https://decapcms.org/docs/external-oauth-clients/) (or [our own](https://github.com/sveltia/sveltia-cms-auth)) to sign in with GitHub, just like Netlify/Decap CMS. We plan to add the GitLab and Test backends, but Azure and Bitbucket are unlikely to be supported, mainly due to the lack of an API method to fetch content in bulk. Later we may implement a performant Git Gateway alternative using GraphQL. |
77
80
  | Configuration | Supported. |
78
81
  | Media | External media storage services are not yet supported. |
79
82
  | Editorial Workflow | Coming soon. |
@@ -92,7 +95,7 @@ While recreating all the features found in Netlify/Decap CMS is not our goal, we
92
95
  | File/Image | The `media_library` options are not yet supported other than `max_file_size` and `choose_url`. |
93
96
  | Map | Not yet supported. |
94
97
  | Markdown | It’s a plain text editor at this time. We’ll soon implement a rich text editor with i18n issues addressed. |
95
- | Relation | The `search_fields` options is not yet supported. The `options_length` option will be ignored because it confuses users and Sveltia CMS doesn’t have the search performance issue. |
98
+ | Relation | The `search_fields` options is not yet supported. |
96
99
 
97
100
  ### Beta features in Netlify/Decap CMS
98
101
 
@@ -105,7 +108,7 @@ While recreating all the features found in Netlify/Decap CMS is not our goal, we
105
108
  | GitLab GraphQL API | The GitLab backend is not yet supported. |
106
109
  | Open Authoring | Not yet supported. |
107
110
  | Folder Collections Path | Supported. |
108
- | Folder Collections Media and Public Folder | Supported. We recommend using an [absolute path per-collection folder](#use-a-custom-media-folder-for-a-collection) for easier asset management rather than a relative path per-entry folder. |
111
+ | Folder Collections Media and Public Folder | Supported. We recommend using [absolute path per-collection folders](#use-a-custom-media-folder-for-a-collection) for easier asset management rather than relative path per-entry folders. |
109
112
  | List Widget: Variable Types | Supported. |
110
113
  | Custom Mount Element | Supported. |
111
114
  | Manual Initialization | Not yet supported. |
@@ -121,6 +124,7 @@ While recreating all the features found in Netlify/Decap CMS is not our goal, we
121
124
 
122
125
  ### Known issues
123
126
 
127
+ - Comprehensive config validation is not implemented yet.
124
128
  - Auto-saving a draft entry is not implemented yet.
125
129
  - Duplicating an entry is not implemented yet.
126
130
  - Accessibility support is limited.
@@ -164,10 +168,6 @@ That’s it! You can open `https://[hostname]/admin/` as before to start editing
164
168
 
165
169
  That said, we highly recommend testing your new Sveltia CMS instance first on your local machine. [See below](#work-with-a-local-git-repository) for how.
166
170
 
167
- ### Bug Report
168
-
169
- Sveltia CMS is still in early beta, so we do expect various issues. Please [report any bug to us](https://github.com/sveltia/sveltia-cms/issues/new).
170
-
171
171
  ## Tips & tricks
172
172
 
173
173
  ### Move your site from Netlify to another hosting service
@@ -237,7 +237,7 @@ Sveltia CMS comes with a handy DeepL integration so that you can translate any t
237
237
 
238
238
  ### Use a random ID for an entry slug
239
239
 
240
- By default, the [slug for a new entry file](https://decapcms.org/docs/configuration-options/#slug) will be generated based on the entry’s `title` field. Or, you can specify the collection’s `slug` option to use the file creation date or other fields. While the behaviour is generally acceptable and SEO-friendly, it’s not useful if the title might change later or if it contains non-Latin characters like Chinese. In Sveltia CMS, you can easily generate a random [UUID](https://developer.mozilla.org/en-US/docs/Glossary/UUID) without a custom widget!
240
+ By default, the [slug for a new entry file](https://decapcms.org/docs/configuration-options/#slug) will be generated based on the entry’s `title` field. Or, you can specify the collection’s `slug` option to use the file creation date or other fields. While the behaviour is generally acceptable and SEO-friendly, it’s not useful if the title might change later or if it contains non-Latin characters like Chinese. In Sveltia CMS, you can easily generate a random [UUID](https://developer.mozilla.org/en-US/docs/Glossary/UUID) for a slug without a custom widget!
241
241
 
242
242
  It’s simple — just specify `{{uuid}}` (full UUID v4), `{{uuid_short}}` (last 12 characters only) or `{{uuid_shorter}}` (first 8 characters only) in the `slug` option. The results would look like `4fc0917c-8aea-4ad5-a476-392bdcf3b642`, `392bdcf3b642` and `4fc0917c`, respectively.
243
243
 
@@ -310,11 +310,13 @@ Importing the CMS as an npm package is not yet supported.
310
310
 
311
311
  ## Support & feedback
312
312
 
313
- Visit the [Discussions](https://github.com/sveltia/sveltia-cms/discussions) page on this GitHub repository and start a new discussion. Tell us your use cases!
313
+ Visit the [Discussions](https://github.com/sveltia/sveltia-cms/discussions) page on this GitHub repository and start a new discussion. Tell us about your use cases!
314
+
315
+ Want to build a website with Sveltia CMS? [@kyoshino](https://github.com/kyoshino) is available for hire depending on your requirements.
314
316
 
315
317
  ## Contributions
316
318
 
317
- Feel free to [file an issue](https://github.com/sveltia/sveltia-cms/issues/new) for a bug report or feature request! Meanwhile, pull requests can probably not be accepted now due to limited review resources. Things may change in late 2023!
319
+ Sveltia CMS is still in early beta, so we do expect various problems. Please [report any bugs to us](https://github.com/sveltia/sveltia-cms/issues/new). Feel free to submit feature requests as well. Meanwhile, pull requests may not be accepted for the time being due to limited review resources.
318
320
 
319
321
  ## Links
320
322