Wykres commitów

48 Commity (main)

Autor SHA1 Wiadomość Data
Sage Abdullah 251d1d188c Expand docs for StreamField block previews 2025-02-03 16:43:29 +00:00
Sage Abdullah f309a44075 Add reference docs for Block.get_template and Block.get_context 2025-02-03 16:43:29 +00:00
Matt Westcott 695ff86c87 Remove versionchanged note for ImageChooserBlock to ImageBlock migration
Leave other versionadded/versionchanged notes intact, as they relate to deprecated features that are not yet removed and should thus be left in place until 7.0.
2025-01-27 18:54:25 +00:00
Sage Abdullah ac4bd79e40
Add initial docs for StreamField block previews 2025-01-20 17:35:06 +00:00
Sage Abdullah 5615deb5b1
Add Django's custom Sphinx roles and use them to link to settings
This is necessary for rST docs, i.e. in docstrings and in eval-rst
blocks. Without this, Sphinx cannot seem to understand the role. See:
https://stackoverflow.com/questions/13387125

MyST-Parser seems to be smarter, it can figure out these custom
roles without having to register the types ourselves. This is evident in
the previous commits where I already use the :setting: role in markdown
docs.
2024-11-05 10:44:40 +00:00
Sage Abdullah 9a5be8f180
Replace more hardcoded Django links with intersphinx in rST docs
Some link labels are changed to just the code part, because using Sphinx
roles for code objects (e.g. methods, attributes) would always format the
text as inline code.

It's currently impossible to customize the formatting of a link's text in
rST. See https://stackoverflow.com/questions/4743845
2024-11-05 10:44:39 +00:00
Matt Westcott 593b95cad9
Document the ability to migrate from ImageChooserBlock to ImageBlock (#12518) 2024-11-01 09:58:42 +00:00
Matt Westcott 93f8600c31
ImageBlock for StreamField (rebase of #11791) (#12416)
Co-authored-by: Chiemezuo <chiemezuoakujobi@gmail.com>
Co-authored-by: Thibaud Colas <thibaudcolas@gmail.com>
2024-10-21 16:11:34 +01:00
Sage Abdullah fd659ae767
Remove versionadded / versionchanged annotations for 6.0 2024-04-22 09:00:36 +07:00
Buraah bfa29201c3 Docs - Page names & reference section - Update British spelling to American
- Changed all British spellings to American spellings, in the Customizing admin templates section of the docs
- Transferred all British spellings in the usage guide and advanced topics section to American spellings
- Update a series of other pages to use the spelling cutomize in the file name
Implemented all feedbacks on the usage guide and advanced topics section
2024-02-12 08:44:19 +10:00
Damilola Oladele 7e774971fa
Documentation: GSoD - A complete tutorial on how to build your Portfolio site with Wagtail (#11217)
Co-authored-by: Meagen Voss <45881480+vossisboss@users.noreply.github.com>
2023-11-17 16:39:37 +00:00
LB Johnston 2e2e8f4452 Minor documentation formatting (Prettier) 2023-11-13 09:53:38 +11:00
Matt Westcott c49ec1bb06 Remove use_json_field parameter from StreamField 2023-11-01 16:52:20 +00:00
Vedant Pandey 837d733097 Add search_index option to control search indexing of StreamField blocks (#11135) 2023-10-31 11:42:16 +00:00
LB Johnston 8002e75775 Documentation - Add initial Stimulus docs
- Move extending React to new extending client-side page within advanced topics
- Add general extending JavaScript / client-side overview
- Prepare initial Stimulus usage documentation
- Resolves #10197
- Apply suggestions from code review - Co-authored-by: Thibaud Colas <thibaudcolas@gmail.com>
2023-10-19 07:28:27 +01:00
Matt Westcott 151a386ff5 Add note to clarify that blocks are not interchangeable with model fields
Prompted by https://stackoverflow.com/questions/76973112/unknown-fields-specified-for-a-page-model-in-wagtail-at-content-panels/76973226?noredirect=1#comment135693718_76973226 and similar misconceptions people have made in the past.
2023-08-30 18:47:57 +01:00
Sage Abdullah 64f496a2e1 Remove old versionadded / versionchanged notes 2023-07-19 17:53:26 +10:00
LB Johnston aa9e9cddc7 Resolve multiple typos (spelling and grammar)
- Optimized/Customized/Catregorize -> Optimised/Customised/Categorise
- Github -> GitHub (80% were spelt with capital H, this is the way GitHub spells itself)
- GitPod -> Gitpod (most were without the capital P, Gitpod's site does not use capital P)
- Remove duplicate words (to to, the the)
- De-coupled -> decoupled
- implementors -> implementers (all other references used 'site implementers' so just aligning with the common case)
- Fix a/an usage in one case
- Fix one comment usage of ok, replace with OK
2023-05-30 21:07:37 +10:00
Thibaud Colas f372551a83 Fix StreamBlock documentation indentation 2023-05-20 07:21:48 +10:00
Matt Westcott d5f787030a Update docs for use_json_field
Indicate that this must now be set to True.
2023-02-10 13:20:34 +00:00
Daniel Kirkham 2204dd05cf Fix indentation of Telepath Adapter example (#9836) 2023-01-03 10:21:13 +00:00
LB Johnston da90061ca8 Docs - formatting - clean up whitespace 2022-12-11 18:43:50 +10:00
Joshua Munn e84cdc4e2c Add wagtail-streamfield-migration-toolkit docs
- Move RichText -> StreamField migration guide into
  advanced/streamfield_migrations.md
2022-12-09 16:40:07 +00:00
LB Johnston 682ed3b21f Clean up unintentional whitespace in documentation 2022-11-20 23:21:56 +10:00
Temidayo b0988d3e2a
Improving the StreamField documentation with class inheritance information (#9451) 2022-11-18 15:09:43 +00:00
LB Johnston 666cc5e8e5 fix up legacy release note refs & use consistent format
- fix some broken refs that were lost in the migration to markdown files
- use lower_snake_case for all internal refs (most follow this convention)
- release process sub-section in docs should be named release schedule instead
2022-08-16 12:42:42 +01:00
Thibaud Colas eac5e0bc2c Finish re-implementing form styles based on design feedback & code review
Co-authored-by: LB Johnston <mail@lb.ee>
2022-08-05 10:36:52 +02:00
Matt Westcott 8f34e47b68 Note that paragraph / line breaks are not counted toward the limit 2022-07-20 13:59:03 +01:00
Matt Westcott 3fa5eb125c Implement max_length validation on RichTextBlock 2022-07-20 13:59:03 +01:00
Dolidodzik b131b4813e replace latin abbreviations with english phrases & updated docs guidelines
- added sub-section to language part of general_guidelines.md
- fixes #8860
2022-07-20 16:11:38 +10:00
LB Johnston 86cb09a534 Documentation - fix streamfield reference issue
- myst was building a doc link `streamfield` and also had a ref link `streamfield` which was causing conflicts
2022-06-30 09:57:26 +10:00
BenedictFaw 952e57b916 Migrate docs for StreamField from md to rst
- relates to #8383
2022-06-09 20:21:50 +10:00
Matt Westcott cdeb1cf479
Add use_json_field=True to all StreamField examples (#8359)
This argument should be used on all new StreamFields created under Wagtail 3. It does add some clutter to the examples, but only using it in select cases would create more confusion...
2022-04-14 11:09:19 +01:00
Matt Westcott 97e781e31c Renumber Wagtail 2.17 to 3.0
As per discussion on https://github.com/wagtail/wagtail/discussions/7732, the changes in the upcoming release (sidebar redesign, removal of hallo.js, module reorganisation) warrant a version bump to 3.0 if we're following semantic versioning.
2022-03-31 06:38:27 +10:00
Sage Abdullah dcae64c255 Allow `StreamField` to use `JSONField` internal type via `use_json_field` kwarg
Add system check for use_json_field in StreamField

Change system check level to Warning

Add use_json_field argument to StreamField in test models

Use RemovedInWagtail219Warning instead of a system check

Handle unpacked values in to_python when use_json_field is True

Duplicate models and tests for JSONField-based StreamField

Add basic tests for JSONField-based StreamField

Add json_field property in StreamField to unify JSONField usage

Add docs

Don't use destructuring for kwargs in deconstruct

Add versionchanged note to StreamField reference
2022-03-29 18:18:08 +01:00
Karl Hobley 75cc7da38a Move wagtail.core to wagtail 2022-03-17 17:19:59 +00:00
Matt Westcott 8d40a978ef Remove old versionadded / versionchanged notes 2022-02-08 19:00:47 +00:00
LB (Ben Johnston) 707ea54f4f Update blocks.rst
Docs does not currently include the `rows` kwarg that is available on `TextBlock`.

See Question on slack https://wagtailcms.slack.com/archives/C81FGJR2S/p1635825388225100
2022-01-08 20:54:20 +10:00
Matt Westcott 980d2c435e collapse option on StreamField, StreamBlock, ListBlock
Fixes #7705
2021-12-01 07:36:54 +10:00
Matt Westcott 0380f01b24 Allow specifying a format for the label of a collapsed StructBlock
Currently, the label shown for a StructBlock's collapsed representation takes its content from the first sub-block of the StructBlock, which isn't always what you want. Add a new `label_format` meta option to StructBlock to allow customising this - e.g. `label_format = "Profile for {first_name} {surname}"`
2021-09-27 19:07:14 +01:00
Matt Westcott 8c97c254a7 Add server-side min_num and max_num validation for ListBlock
Fixes #5300
2021-07-14 13:14:15 +01:00
Matt Westcott bdfa3811d1 Remove outdated versionadded/versionchanged annotations 2021-07-13 17:10:56 +01:00
Petr Dlouhý 50e4f5151d fix small youtube embed - allow to override max_width/max_height in EmbedBlock 2021-06-25 16:15:09 +01:00
Matt Westcott 9d29ba862c Document idForLabel on the telepath widget API
Fixes #7145
2021-05-04 16:01:01 +01:00
Matt Westcott 571b9e1918 Add example of a widget adapter class 2021-03-23 18:57:53 +00:00
Matt Westcott 3e2c928e2f Add StreamField context to block examples 2021-03-23 18:57:53 +00:00
Matt Westcott 0f75fb14f1 Add reference page for the client-side widget API 2021-03-23 18:57:53 +00:00
Matt Westcott b3c39216f2 Create a 'streamfield' subsection within the reference docs 2021-03-23 18:57:53 +00:00