mirror of
https://gitlab.com/randompenguin/bookface.git
synced 2025-06-07 19:14:26 +02:00
Update For Friendica Users
parent
b52085f817
commit
68fa5e5d14
1 changed files with 139 additions and 5 deletions
|
@ -38,7 +38,7 @@ If your Friendica server offers _Bookface_ you simply need to select the "Frio"
|
|||
|
||||
If your Friendica instance does not offer the _Bookface_ schemes you will have to install the Userstyles in your browser instead. Exactly _how_ you do this will depend on what web browser you are using, and it will _only_ apply to that browser on that specific device.
|
||||
|
||||
### FIREFOX
|
||||
### Firefox
|
||||
|
||||
You have two options if you are using the Firefox browser (or any browser based on it).
|
||||
|
||||
|
@ -151,7 +151,7 @@ From version 1.3 Bookface supports adding a "Cover Photo" to your profile pages.
|
|||
|
||||
Note that this feature only works in recent, modern browsers! Every current and supported desktop and mobile version should be able to show it, but nothing unsupported nor released before 2022 will (see caniuse.com entry for "has()" for specific versions).
|
||||
|
||||
### ON ALL PROFILE PAGES
|
||||
### On ALL Profile Pages
|
||||
|
||||
1. Go to Settings \> Profile \> Personal
|
||||
2. In the "Description" box add something like:
|
||||
|
@ -163,7 +163,7 @@ Note that this feature only works in recent, modern browsers! Every current and
|
|||
|
||||
For people who are not using the _Bookface_ scheme they will simply see a thumbnail image of your Cover Photo in the sidebar beneath your profile description. For people who ARE using the _Bookface_ scheme they will see your Cover Photo as a background on your Profile, Conversations, Photos, etc., pages that have a sidebar with your "vcard" info.
|
||||
|
||||
### ONLY ON PROFILE PAGE
|
||||
### ONLY On Profile Page
|
||||
|
||||
1. Go to Settings \> Profile \> Custom Profile Fields
|
||||
2. Either create a new entry for your Cover Photo or add the BBcode to an existing "Value" field:
|
||||
|
@ -176,7 +176,7 @@ For people who are not using the _Bookface_ scheme they will simply see a thumbn
|
|||
|
||||
People who are not using the _Bookface_ scheme will simply see a thumbnail on your Profile Page in your custom fields. The Cover Photo will _ONLY_ appear on that Profile page (not on your Conversations, Photos, Contacts, etc. pages).
|
||||
|
||||
### MULTIPLE COVER PHOTOS
|
||||
### Multiple Cover Photos
|
||||
|
||||

|
||||
|
||||
|
@ -186,4 +186,138 @@ While it is not really recommended you do this, you can place up to FOUR images
|
|||
|
||||
{width="536" height="422"}
|
||||
|
||||
Extra spaces are okay, but make sure there are no newlines/carriage returns or other elements inside the `[class]...[/class] `or it will mis-count the number of images and size them wrongly. Also keep in mind people not using Bookface will see multiple thumbnails of these images on your Profile. Only Bookface users will see the collage.
|
||||
Extra spaces are okay, but make sure there are no newlines/carriage returns or other elements inside the `[class]...[/class] `or it will mis-count the number of images and size them wrongly. Also keep in mind people not using Bookface will see multiple thumbnails of these images on your Profile. Only Bookface users will see the collage.
|
||||
|
||||
# POSTBOXES
|
||||
|
||||
You have, no doubt, seen social media posts sharing a screencap of some large text against a color background. These often become memes.
|
||||
|
||||

|
||||
|
||||
What you may not know is that many of them originated on Facebook and got shared as screencaps on other social media platforms because there was no way to share them directly. Facebook has a feature to add a custom background to a text-only post under 132 characters long. It is unclear if Meta actually has a name for this feature, but we need to call it something so here they will be referred to as "Postboxes." Because they are colorful boxes with a post inside.
|
||||
|
||||
**Starting with Bookface version 1.6 now Friendica will have Postboxes too!** Styling similar to the Facebook solid color and gradient backgrounds have been added to the Bookface stylesheets.
|
||||
|
||||
### How to Use Postboxes
|
||||
|
||||
To make use of a Friendica Postbox simply wrap the text inside a Postbox Class BBcode like this:
|
||||
|
||||
`[class=postbox-red]This is the wrapped text[/class]`
|
||||
|
||||
#### Available Color Options
|
||||
|
||||

|
||||
|
||||
In the `[class]` opener add `postbox-` plus any one of the color names after the "=" sign.
|
||||
|
||||
**Solid Color Backgrounds:**
|
||||
|
||||
* postbox-black
|
||||
* postbox-red
|
||||
* postbox-green
|
||||
* postbox-blue
|
||||
* postbox-orange
|
||||
* postbox-purple
|
||||
* postbox-forest
|
||||
* postbox-ocean
|
||||
* postbox-pink
|
||||
* postbox-salmon
|
||||
|
||||
**Gradient Backgrounds:**
|
||||
|
||||
* postbox-darkgray
|
||||
* postbox-minty
|
||||
* postbox-mintgray
|
||||
* postbox-redblue
|
||||
* postbox-violets
|
||||
* postbox-grayblack
|
||||
* postbox-tealblue
|
||||
* postbox-greengray
|
||||
* postbox-tealgray
|
||||
* postbox-bluegray
|
||||
* postbox-lavendergray
|
||||
* postbox-sunset
|
||||
* postbox-sherbert
|
||||
|
||||
#### Content Restrictions
|
||||
|
||||
Friendica's Postbox is a bit more forgiving as it allows for more than text-only content. However it does not work with most of the Friendica formatting due to the way BBcode is parsed.
|
||||
|
||||
**BBcodes you CANNOT put inside a Postbox:**
|
||||
|
||||
* \[class\], which means you can’t nest Postboxes
|
||||
* \[hr\]
|
||||
* \[h1\],\[h2\],\[h3\], etc…
|
||||
* \[table\],\[tr\],\[th\],\[td\]
|
||||
* \[list\],\[ul\],\[ol\]
|
||||
* \[abstract\]
|
||||
* \[spoiler\]
|
||||
* \[map\]
|
||||
* \[code\]
|
||||
|
||||
**BBcodes that do not work as intended inside a Postbox:**
|
||||
|
||||
* \[pre\]
|
||||
* \[noparse\]
|
||||
* \[nobb\]
|
||||
|
||||
The text will show but will be styled and centered.
|
||||
|
||||
**BBcodes that DO WORK inside a Postbox:**
|
||||
|
||||
* \[url\]
|
||||
* \[img\]
|
||||
* \[audio\]
|
||||
* \[video\]
|
||||
|
||||
Plus any plain text, including emoji
|
||||
|
||||
If you are using Markdown formatting what you can and can’t put in a Postbox is similar, with the exception that (because of how Markdown is parsed into BBcode) you can’t have both a URL and an image in the same Postbox. You _can_ however put inline `code` in a Postbox with Markdown where BBcode cannot.
|
||||
|
||||
Step-By-Step Visual Example
|
||||
|
||||
1. Compose It:
|
||||
|
||||

|
||||
|
||||
2. Preview It
|
||||
|
||||

|
||||
|
||||
3. Post it!
|
||||
|
||||

|
||||
|
||||
To anyone on Friendica who is not using the Bookface scheme, however, it won't be "Postboxed" at all. This is what that post would look like to someone using the stock "Frio" theme with the "Light" scheme:
|
||||
|
||||

|
||||
|
||||
**_Note:_** _the exception would be if your server admin has implemented the optional "_[_Postbox_](https://gitlab.com/randompenguin/postbox)_" or "_[_Zen Postbox_](https://gitlab.com/randompenguin/zen_postbox)_" add-ons for Friendica which enable Postbox styling regardless of the theme or scheme._
|
||||
|
||||
Obviously if your post gets shared to another platform like Mastodon, Sharkey, Diaspora, Hubzilla, etc., it also will not have the Postbox styling. Same goes for anyone viewing your post in a third-party app because none of them support Postbox styling, at least not yet.
|
||||
|
||||
**Right now Postbox is exclusively available for people using the Friendica webapp, either desktop or mobile.**
|
||||
|
||||
### Special Use Cases
|
||||
|
||||
#### Famous Quotes
|
||||
|
||||
One neat thing you can do with a Postbox is use it for a quote. You've no doubt seen many social media posts with a quote from a famous person and their image. Since Postboxes support adding images you can create a nice looking quote box without using a third-party service to generate and link an image.
|
||||
|
||||

|
||||
|
||||
And this is what it looks like in the stock "Frio" theme using the "Light" scheme:
|
||||
|
||||

|
||||
|
||||
Again, as noted above, the Postbox styling will not be seen by anyone on a third-party app or another platform, and will only be seen by other Friendica users if they are using the Bookface scheme or if their server administrator has enabled Postbox styling for all users.
|
||||
|
||||
#### Multiple Postboxes
|
||||
|
||||
You can have multiple Postboxes in a single post, each with a different style applied.
|
||||
|
||||
Be careful when you add multiple post boxes to put a space or line return between them or they will bunch up in a row instead of a column:
|
||||
|
||||

|
||||
|
||||

|
Loading…
Add table
Add a link
Reference in a new issue