You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/releases/v13/upgrade-v13.0.md
+1-17Lines changed: 1 addition & 17 deletions
Original file line number
Diff line number
Diff line change
@@ -26,22 +26,6 @@ invenio-cli, version 1.8.0
26
26
In case you are not inside a virtual environment, make sure that you prefix each `invenio`
27
27
command with `pipenv run`.
28
28
29
-
**Local development**
30
-
31
-
Changing the Python version in your development environment highly
32
-
depends on your setup, so we won't cover it here.
33
-
One way would be to use [PyEnv](https://github.com/pyenv/pyenv).
34
-
35
-
!!! warning "Risk of losing data"
36
-
37
-
Your virtual environment folder a.k.a., `venv` folder, may contain uploaded files. If you kept the default
38
-
location, it is in `<venv folder>/var/instance/data`. If you need to keep those files,
39
-
make sure you copy them over to the new `venv` folder in the same location.
40
-
The command `invenio files location list` shows the file upload location.
41
-
42
-
If you upgraded your python version, you should recreate your virtual environment before
43
-
running `invenio-cli` or `pipenv` commands below.
44
-
45
29
### Upgrade InvenioRDM
46
30
47
31
#### Requirements
@@ -193,7 +177,7 @@ If you choose to delete and re-create your search cluster as part of the upgrade
193
177
Be sure to repeat the [Rebuild search indices](#rebuild-search-indices) step to ensure your system is fully functional.
194
178
195
179
#### Jobs
196
-
The new Jobs feature uses a custom celery task scheduler which requires a separate celery beat. See the [related documentation](../../operate/customize/jobs.md#scheduler)on how to add it or [this change](https://github.com/inveniosoftware/cookiecutter-invenio-rdm/pull/314) in the InvenioRDM boilerplate for reference.
180
+
The new Jobs feature uses a custom celery task scheduler which requires a separate celery beat. See the [related documentation](../../operate/customize/jobs.md#scheduler) or [the scheduler service](https://github.com/inveniosoftware/cookiecutter-invenio-rdm/blob/master/%7B%7Bcookiecutter.project_shortname%7D%7D/docker-compose.full.yml) in the InvenioRDM boilerplate for how to add it.
197
181
198
182
!!! note
199
183
Be sure to run this additional Celery beat scheduler in your production or deployed environments. Without it, scheduled and on-demand jobs will not be executed.
Copy file name to clipboardExpand all lines: docs/releases/v13/version-v13.0.0.md
+17-23Lines changed: 17 additions & 23 deletions
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
_2025-07-21_
4
4
5
-
We're happy to announce the release of InvenioRDM v13.0! Version 13 will be maintained until at least 6 months following the next release. Visit our maintenance policy page to learn more.
5
+
We're happy to announce the release of InvenioRDM v13.0! Version 13 will be maintained until at least 6 months following the next release. Visit our [maintenance policy page](../maintenance-policy.md) to learn more.
6
6
7
7
## Try it
8
8
@@ -48,7 +48,7 @@ Communities can now have their own theming with a custom font and colors, which
48
48
49
49

50
50
51
-
Themed communities benefit from a custom homepage, defined by changing its HTML template.
51
+
Themed communities can have a custom homepage defined by overriding the default Jinja template.
52
52
53
53
Read more about the [themes communities feature](../../operate/customize/look-and-feel/themed_communities.md).
54
54
@@ -68,15 +68,17 @@ Collections introduce a powerful new way to organize and curate records within y
68
68
Collections provide dedicated pages showing all records matching specific criteria.
69
69
///
70
70
71
-
**Hierarchical organization**
71
+
*Hierarchical organization*
72
+
72
73
Collections allow you to define hierarchical groupings of records, enabling users to browse content by subject, resource type, funding program, or any other metadata field.
73
74
74
75

75
76
/// caption
76
77
The collection browser provides an organized view of all available collections within a community.
77
78
///
78
79
79
-
**Common use cases**
80
+
*Common use cases*
81
+
80
82
- Group content by research disciplines using a hierarchical vocabulary
81
83
- Organize historical records by publication date
82
84
- Organize records by funding programs (Horizon 2020, NSF, institutional grants)
@@ -97,7 +99,7 @@ Curation checks in Zenodo's EU Open Research Repository
97
99
98
100
Read the detailed documentation for [Curation checks](../../operate/customize/curation-checks.md).
99
101
100
-
### Customizable compliance info when publishing
102
+
### Customizable compliance information when publishing
101
103
You can now fully customize the compliance information and checkboxes that users must acknowledge when publishing a record. This makes it easy to tailor the publishing workflow to your organization's policies or legal requirements.
102
104
103
105

@@ -110,11 +112,11 @@ You can now let users to choose if they need a DOI or not when uploading. See ho
110
112

111
113
112
114
### Extra PIDs schemes
113
-
InvenioRDM v13 allows you to extend the list of existing schemes for persistent identifiers to detect, validate and add support for your owns.
115
+
InvenioRDM v13 allows you to extend the list of existing persistent identifier schemes to detect, validate and support any additional ones you want.
See the [related documentation](../../operate/customize/metadata/custom_pids_schemes.md) how to add your own custom schemes.
119
+
See the [related documentation](../../operate/customize/metadata/custom_pids_schemes.md)for how to add your own custom schemes.
118
120
119
121
Under the hood, the Invenio [idutils](https://github.com/inveniosoftware/idutils) module handles validation and normalization of persistent identifiers used in scholarly communication, and existing customizations may be affected by changes in v13. The module has been restructured to use a configurable scheme system with a new entrypoint mechanism for registering your own identifier schemes.
120
122
@@ -134,7 +136,7 @@ You can now setup jobs to automatically and recurrently fetch ORCID and ROR late
134
136
135
137
For ORCID, read more on the [names vocabulary](../../operate/customize/vocabularies/names.md#using-orcid-public-data-sync) documentation page.
136
138
137
-
With the ROR job, you can automatically load funders or affiliations vocabulary from the InvenioRDM administration panel, and schedule updates with new ROR releases. Instructions can be found on the [affiliations vocabulary](../../operate/customize/vocabularies/affiliations.md) documentation page.
139
+
With the ROR job, you can automatically load the affiliations or funders vocabulary from the InvenioRDM administration panel, and schedule updates with new ROR releases. Instructions can be found on the [affiliations](../../operate/customize/vocabularies/affiliations.md)and [funding](../../operate/customize/vocabularies/funding.md)documentation pages respectively.
138
140
We have also upgraded the integration with ROR to version 2.0 and enhanced the metadata to include organization aliases, status, types, locations, and acronyms, making it easier to find the correct organization or funders.
139
141
140
142
#### EuroSciVoc subjects
@@ -159,7 +161,7 @@ We have introduced new metadata fields that will allow you to capture more usefu
159
161
The v13 release features an upgraded PDF previewer, now powered by [PDF.js v4](https://github.com/mozilla/pdf.js). This update resolves previous issues with failed previews for certain PDF files, providing a more reliable and seamless viewing experience.
160
162
161
163
### Requests sharing
162
-
When a record is shared, the review request is now also accessible. We have introduced a new search filter in `My Dashboard`, to easily find records shared with me.
164
+
When a record is shared, the review request is now also accessible. We have introduced a new search filter in `My Dashboard`, to easily find records shared with you.
163
165
164
166

165
167
@@ -169,12 +171,12 @@ Both users and records search have been enhanced to return more accurate results
169
171
Creators, affiliations and funders autocompletion has been improved so that suggestions appear faster and better match what you type.
170
172
171
173
### Sitemaps
172
-
InvenioRDM v13 introduces the automatic generation of sitemaps to help search engines and other crawlers discovering and indexing your repository's content. Sitemaps are even automatically linked in your `robots.txt`.
174
+
InvenioRDM v13 introduces the automatic generation of sitemaps to help search engines and other crawlers discover and index your repository's content. Sitemaps are even automatically linked in your `robots.txt`.
173
175
174
-
See the [related documentation](../../operate/customize/sitemaps.md) to learn how to configure it.
176
+
See the [related documentation](../../operate/customize/sitemaps.md) to learn how to configure their generation.
175
177
176
178
### Miscellaneous additions
177
-
Here is a quick summary of the myriad other improvements in this release:
179
+
Here is a quick summary of the myriad of other improvements in this release:
178
180
179
181
- A convenient "Copy" button has been added next to the DOI (when enabled) and export formats, allowing users to instantly copy these values to their clipboard with a single click without manually selecting or exporting the content:
180
182

@@ -200,9 +202,8 @@ Here is a quick summary of the myriad other improvements in this release:
200
202
- Following the [latest COUNTER spec](https://www.countermetrics.org/code-of-practice/), the [list of robots and machines](https://github.com/inveniosoftware/counter-robots) have been updated to ensure the stats are counted on human usage.
201
203
- Logging: the Flask root logger level has been changed from `undefined` to `DEBUG`. This enables all log messages to pass through by default, instead of being blocked. If you have implemented custom logging handlers, ensure that you have defined the logging level and verify your logging verbosity in deployed environments to avoid excessive logs.
202
204
- The issue related to storage quota per record for a given user has been solved. You can now define different storage quotas per record.
203
-
- InvenioRDM v13 introduces the `generator` HTML `meta` tag to identify the repository technology. This is used by services like [OpenDOAR](https://opendoar.ac.uk/) to correctly catalog open access repositories.
204
-
The generator string will be `InvenioRDM v13.0`. You can change it in your `invenio.cfg` by overriding the variable `THEME_GENERATOR` or setting it to `None` to disable the meta tag.
205
205
- MathJax: when enabled, it will now render mathematical formulas also in the landing page citation box, search results and request's comments pages.
206
+
- Easier link generation: it's now possible to use `from invenio_base import invenio_url_for` to generate API links in the UI application and vice versa. When configuring services, `from invenio_records_resources.services import EndpointLink` now replaces `Link` which establishes a single source of truth for links.
206
207
- ...and many more bug fixes!
207
208
208
209
### Experimental
@@ -216,6 +217,7 @@ These tools are **disabled by default** and will be tested further in the coming
216
217
- The integration with the new ROR schema v2 requires to re-import both the affiliations and funders vocabularies. See the [upgrade guide](upgrade-v13.0.md#updated-affiliations-and-funders) for more information.
217
218
- The upgrade of the PDF previewer requires a small change to the webserver configuration. See the [upgrade guide](upgrade-v13.0.md) for more information.
218
219
- Direct Python imports of identifier schemes (e.g., `from idutils.isbn import normalize_isbn`) are now deprecated and will be removed in future versions. If you have custom code that directly imports scheme modules, you'll need to update it to use the new API.
220
+
- Usage of `from invenio_records_resources import Link` is deprecated in favor of `EndpointLink` for InvenioRDM links and `ExternalLink` for external third-party links. `Link` will be removed in a future major InvenioRDM release.
219
221
220
222
## Requirements
221
223
@@ -243,7 +245,7 @@ The development work of this impressive release wouldn't have been possible with
243
245
- Alex Ioannidis
244
246
- Alzbeta Pokorna
245
247
- Anika Churilova
246
-
- Austin
248
+
- Austin Sharp
247
249
- Brian Kelly
248
250
- Carlin MacKenzie
249
251
- Christoph Ladurner
@@ -254,16 +256,13 @@ The development work of this impressive release wouldn't have been possible with
254
256
- ducica
255
257
- Eduard Nitu
256
258
- Emil Dandanell Agerschou
257
-
- enitu
258
259
- Eric Newman
259
260
- Eric Phetteplace
260
261
- Esteban J. G. Gabancho
261
262
- Fatimah Zulfiqar
262
263
- Felipe Carlos
263
264
- Florian Gantner
264
265
- Furkan Kalkan
265
-
- furkankalkan
266
-
- Gantner, Florian Klaus
267
266
- Guillaume Viger
268
267
- Hrafn Malmquist
269
268
- Ian W. Scott
@@ -276,7 +275,6 @@ The development work of this impressive release wouldn't have been possible with
276
275
- Martin Fenner
277
276
- Martin Obersteiner
278
277
- Matt Carson
279
-
- Max
280
278
- Maximilian Moser
281
279
- mb-wali
282
280
- Michael Groh
@@ -288,15 +286,11 @@ The development work of this impressive release wouldn't have been possible with
0 commit comments