Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added information about copying blocks #325

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Conversation

mnocon
Copy link
Contributor

@mnocon mnocon commented Dec 9, 2024

@mnocon mnocon force-pushed the copy-paste-blocks branch from 1d801e5 to 40a5f69 Compare December 9, 2024 21:12
@mnocon mnocon marked this pull request as ready for review December 10, 2024 07:58
@mnocon mnocon requested a review from dew326 December 10, 2024 07:58
- Duplicate - duplicates existing block with its settings
- Refresh - refreshes preview of the block
- Delete - deletes existing block

![Block window - size adjustment](img/block_window_size_adjust.png "Block window - size adjustment")

#### Copy blocks

Copying blocks allows you to reuse configured blocks across different pages.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Copying blocks allows you to reuse configured blocks across different pages.
You can copy blocks to reuse them on other pages.

I'd focus on the reader, not the ssystem.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick: you can use it on the same page as well.


Copying blocks allows you to reuse configured blocks across different pages.

When you execute the "Copy" action on a block, it creates a new entry in the "Clipboard" section of the Page Blocks toolbox. Inserting the block from the clipboard adds an exact replica of the block, including its configuration, as it existed at the time of copying.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When you execute the "Copy" action on a block, it creates a new entry in the "Clipboard" section of the Page Blocks toolbox. Inserting the block from the clipboard adds an exact replica of the block, including its configuration, as it existed at the time of copying.
When you copy a block, it gets saved in the "Clipboard" section of the Page Blocks toolbox.
Inserting the block from the clipboard puts an exact copy of it, with all its settings, as it was when you copied it.

How exactly do you insert a block? I'd focus on the steps, not the behavior of the system, something along the lines of:
"To do it, in the block's toolbar, click Copy. Then, in the Page Blocks toolbox, copy the content of the Clipboard section. You can now switch to another page and insert the block by..."

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can drag and drop the block from the clipboard section to the page - exactly like the other blocks (the only difference is that it's inserted preconfigured).


When you execute the "Copy" action on a block, it creates a new entry in the "Clipboard" section of the Page Blocks toolbox. Inserting the block from the clipboard adds an exact replica of the block, including its configuration, as it existed at the time of copying.

The clipboard can store only one block at a time. The content of the clipboard remains accessible while editing pages and is visible only to you.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The clipboard can store only one block at a time. The content of the clipboard remains accessible while editing pages and is visible only to you.
The clipboard can store only one block at a time.
The content of the clipboard remains accessible while editing pages and is visible only to you.

"accessible while editing pages " does it persist closing one page and opening another for editing?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, exactly, that's the main use case - for "single page editing" the Duplicate action is much faster, copying is for copying a block across different pages.

- Duplicate - duplicates existing block with its settings
- Refresh - refreshes preview of the block
- Delete - deletes existing block

![Block window - size adjustment](img/block_window_size_adjust.png "Block window - size adjustment")

#### Copy blocks

Copying blocks allows you to reuse configured blocks across different pages.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick: you can use it on the same page as well.

@mnocon
Copy link
Contributor Author

mnocon commented Dec 10, 2024

nitpick: you can use it on the same page as well.

For that I'd use the duplicate action, so I'd not focus on that use case (even though it's true) 😄


You can copy blocks to reuse them on other pages.

When you copy a block, it gets saved in the "Clipboard" section of the Page Blocks toolbox.

This comment was marked as resolved.

This comment was marked as resolved.

You can copy blocks to reuse them on other pages.

When you copy a block, it gets saved in the "Clipboard" section of the Page Blocks toolbox.
From there you can drag and drop the block to the page like any other block.

This comment was marked as resolved.

Doing so puts an exact copy of the block on the page, with all its settings, as it was when you copied it.

The clipboard can store only one block at a time.
The content of the clipboard remains accessible while editing different pages and is visible only to you.

This comment was marked as outdated.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've chosen preserve switching into a new session

@mnocon mnocon requested a review from dabrt December 17, 2024 11:34
Copy link
Contributor

@julitafalcondusza julitafalcondusza left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check my comments.

docs/content_management/create_edit_pages.md Outdated Show resolved Hide resolved
docs/content_management/create_edit_pages.md Outdated Show resolved Hide resolved
docs/content_management/create_edit_pages.md Outdated Show resolved Hide resolved
Co-authored-by: julitafalcondusza <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants