[IMP] blog: update and restructure blog documentation

Task - 5136454

Author: jacbodoo

content/applications/websites/blog.rst

@@ -9,67 +9,23 @@ build a community.
    If the Blog module is not yet installed, click :guilabel:`+New` on the website builder, select
    :guilabel:`Blog Post`, and click :guilabel:`Install`.
 
-Creating a blog
-===============
+Blog page
+=========
 
-To create or edit a blog, go to :menuselection:`Website --> Configuration --> Blogs: Blogs`. Click
+Create a blog page
+------------------
+
+To create or edit a blog, go to :menuselection:`Website --> Configuration --> Blogs`. Click
 :guilabel:`New`, and enter the :guilabel:`Blog Name` and the :guilabel:`Blog Subtitle`.
 
 The :guilabel:`Blog` menu item is added to your website's menu the first time you create a blog and
 gathers all your blogs.
 
-Adding a blog post
-==================
-
-Go to your website, click :guilabel:`+New` in the top-right corner, and select
-:guilabel:`Blog Post`. In the pop-up, **select the blog** where the post should appear, write the
-post's :guilabel:`Title`, and :guilabel:`Save`. You can then write the post's content and customize
-the page using the website builder.
-
-.. tip::
-   - Illustrate your articles with copyright-free images from :doc:`Unsplash
-     </applications/general/integrations/unsplash>`.
-   - Type `/` in the text editor to format and add elements to your text.
-
-.. important::
-   Don't forget to toggle the :guilabel:`Unpublished` switch in the top-right corner to publish
-   your post.
-
-Using tags
-==========
-
-Tags let visitors filter all posts sharing the same tag. By default, they are displayed at the
-bottom of posts, but can also be displayed on the blog's main page. To do so, click
-:menuselection:`Edit --> Customize` and enable the :guilabel:`Sidebar`. By default, the sidebar's
-:guilabel:`Tags List` is enabled.
-
-To create a tag, go to :menuselection:`Website --> Configuration --> Blogs: Tags` and click
-:guilabel:`New`. Fill in the:
-
-- :guilabel:`Name`
-- :guilabel:`Category`: tag categories let you group tags displayed on the sidebar by theme.
-- :guilabel:`Used in`: to apply the tag to existing blog posts, click :guilabel:`Add a line`,
-  select the posts, and click :guilabel:`Select`.
-
-You can add and create tags directly from posts by clicking :menuselection:`Edit --> Customize` and
-select the post's cover. Under :guilabel:`Tags`, click :guilabel:`Choose a record...`, and select
-or create a tag.
-
-.. image:: blog/create-tag.png
-   :alt: Adding a tag to a blog post
-
-.. note::
-   To manage tag categories, go to :menuselection:`Website --> Configuration --> Blogs: Tag
-   Categories`.
-
-Customizing blog homepages
-==========================
+Customize blog pages
+--------------------
 
 Customize the content of blog homepages by opening a blog homepage and clicking :menuselection:`Edit
---> Customize`.
-
-.. note::
-   Settings apply to **all** blogs homepages.
+--> Style`.
 
 :guilabel:`Top Banner`: :guilabel:`Name/Latest Post` displays the title of the latest post on the
 top banner, while :guilabel:`Drop Zone for Building Blocks` removes the top banner and lets you use
@@ -80,12 +36,12 @@ any building block instead.
 - :guilabel:`Cards`: adds a *card* effect.
 - :guilabel:`Increase Readability`: improves the text's readability.
 
-:guilabel:`Sidebar`: displays a sidebar containing an :guilabel:`About us` section.
+:guilabel:`Sidebar`: displays a sidebar containing additional information, such as:
 
 - :guilabel:`Archives`: allows visitors to select a month and filter all posts created during that
   month.
 - :guilabel:`Follow Us`: displays links to your social media networks. They can be configured using
-  the Social Media building block somewhere on your website.
+  the Social Media building block on your website.
 - :guilabel:`Tags List`: displays all tags related to a blog. Visitors can select a tag to filter
   all related posts.
 
@@ -96,13 +52,33 @@ them.
 - :guilabel:`Comments/Views Stats`: displays the posts' number of comments and views.
 - :guilabel:`Teaser & Tags`: displays the posts' first sentences and tags.
 
-Customizing blog posts
-======================
+.. note::
+   Settings apply to **all** blogs pages.
 
-Customize posts by opening a blog post and clicking :menuselection:`Edit --> Customize`.
+Blog post
+=========
 
-.. note::
-   Settings apply to **all** posts.
+Create a blog post
+------------------
+
+Go to your website, click :guilabel:`New` in the top-right corner, and select
+:guilabel:`Blog Post`. In the pop-up, **select the blog** where the post should appear, write the
+post's :guilabel:`Title`, and :guilabel:`Save`. You can then write the post's content and customize
+the page using the website builder.
+
+.. tip::
+   - Illustrate your articles with copyright-free images from :doc:`Unsplash
+     </applications/general/integrations/unsplash>`.
+   - Type `/` in the text editor to format and add elements to your text.
+
+.. important::
+   Don't forget to toggle the :guilabel:`Unpublished` switch in the top-right corner to publish
+   your post.
+
+Customize blog posts
+--------------------
+
+Customize posts by opening a blog post and clicking :menuselection:`Edit --> Style`.
 
 :guilabel:`Layout`: :guilabel:`Title Inside Cover` displays the title inside the cover image, and
 :guilabel:`Title above Cover` displays it above.
@@ -123,7 +99,145 @@ Customize posts by opening a blog post and clicking :menuselection:`Edit --> Cus
 :guilabel:`Bottom`: :guilabel:`Next Article` displays the next post at the bottom, and
 :guilabel:`Comments` enable visitors to comment on the post.
 
-:guilabel:`Select To Tweet`: visitors are offered to tweet the text they select.
+.. note::
+   Settings apply to **all** posts.
 
 .. tip::
    Use :ref:`Plausible <analytics/plausible>` to keep track of the traffic on your blog.
+
+
+.. seealso::
+   - `Odoo Tutorials: Blogs [video] <https://www.odoo.com/slides/slide/blogs-6935>`_
+
+Use the `/` to activate some functions that will help you generate some content by adding bullet
+lists, tables, quotes, columns, links, images, videos etc.
+Amongst the available options, there is an AI tool to help you generate your content as you wish.
+
+Also, the customization tool to configure the text format appears when hovering the mouse over the
+selected text.
+
+You can choose the type of heading you like for a text, decide the format, the size, the color, the
+highlight, the alignment, add bullets or numbers, add links, and add effects and animation to the
+text. You can also translate, generate, or transform a text with AI. When you click on the AI option,
+a chat box appears, allowing you to request a specific text feature.
+
+These options will help you structure your content effectively.
+
+.. Note:: You should never have more than one Heading 1
+
+Tags
+====
+
+Tags let visitors filter all posts sharing the same tag. By default, they are displayed at the
+bottom of posts, but can also be displayed on the blog's main page. To do so, click
+:menuselection:`Edit --> Style` and enable the :guilabel:`Sidebar`. By default, the sidebar's
+:guilabel:`Tags List` is enabled.license. The project is hosted on GitHub.
+
+Create tags
+-----------
+
+To create a tag, go to :menuselection:`Website --> Configuration --> Tags` and click
+:guilabel:`New`. Fill in the:
+
+- :guilabel:`Name`
+- :guilabel:`Category`: tag categories let your group tags displayed on the sidebar by theme.
+- :guilabel:`Used in`: to apply the tag to existing blog posts, click :guilabel:`Add a line`,
+  select the posts, and click :guilabel:`Select`.
+
+You can add and create tags directly from posts by clicking :menuselection:`Edit --> Style` and
+select the post's cover. Under :guilabel:`Tags`, click :guilabel:`Choose a record...`, and select
+or create a tag. You can create a tag by writing something in the search bar and clicking on
+:guilabel:`Create "..."`.
+
+.. image:: blog/tags-blog.png
+   :alt: Adding a tag to a blog post
+
+Create tag category
+-------------------
+
+To create tag categories, go to :menuselection:`Website --> Configuration --> Tag
+Categories --> New`.
+
+Blog building block
+===================
+
+Add the building block in your website
+--------------------------------------
+
+Add a blog building block anywhere on any page of your website to improve visibility of the recent
+content and encourage visitors to explore more content.
+
+You can add a building block ‘Blogs’ by dragging and dropping it anywhere in any page of your
+website.
+For example, on your homepage, click on :guilabel:`Edit`, search for the :guilabel:`Blogs` block,
+drag it, and drop it where you want on the page to display your articles, which will be accessible
+to your visitors.
+
+Customize your building block
+-----------------------------
+
+Customize your blog building block through the edition feature.
+
+- Choose the :guilabel:`background` of the block by changing the :guilabel:`color` or adding a :guilabel:`picture`, a :guilabel:`video` or a :guilabel:`shape`
+- Choose the :guilabel:`width` and the :guilabel:`height` of the content
+- Filter by the :guilabel:`latest blog posts` or the :guilabel:`most viewed blog posts`
+- Determine the display of the blogs by choosing a template
+- Change the :guilabel:`picture size`, define a :guilabel:`Hover effect`
+- Decide how many blogs can appear amongst all of them by modifying the number of
+:guilabel:`fetched elements`
+- Decide if they can be visible on computers or mobile devices with or without conditions
+through the :guilabel:`Visibility` field.
+
+Use SEO for your blog
+======================
+
+Improve your SEO
+----------------
+
+Update the content of your website regularly to improve your SEO. This will attract more visitors
+and more clicks.
+
+Use SEO to increase your blogs' visibility in search engines, attract visitors and ensure that
+readers can easily find relevant content.
+
+- Keep your blog active and keep it fresh by regularly updating your content
+- Integrate `keywords` (see `Use Alt Tag`), use long-tail keywords: for better ranking and to promote
+  low-competition search queries
+- Promote an engaging blog to keeps visitors on your website longer
+
+Here are some useful tips:
+
+Add alt Tag
+~~~~~~~~~~~
+Add :guilabel:`keywords` to your images by using the :guilabel:`Alt Tag` option.
+This allows search engines to identify the content of the image or visual
+
+Click on :guilabel:`Edit`, then click on the image. On the edition sidebar, on the :guilabel:`image`
+section, the field `Description` and `Tooltip` can be filled with keywords to describe the image.
+
+
+Add strong tag (bold)
+~~~~~~~~~~~~~~~~~~~~~
+Strong tag `<strong>`, old characters, helps Google identify key terms in your content. It enhances
+readability by guiding users to key points.
+
+.. Note:: Using bold too much can becomes less effective and can have a negative impact on your SEO.
+   Make sure not to overuse it.
+
+Add translation
+~~~~~~~~~~~~~~~
+
+Translate your website, your blogs, to allow search engines to show your content to people in
+different languages. This helps you reach a wider audience.
+
+Alt tag
+*******
+Translate metadata, alt tag (meta descriptions, title tags, and alt tags) on your images.
+
+Text
+****
+
+- Odoo provides a language switcher to avoid mixing multiple languages in pages of a website. Add
+  languages to your website so that visitors can use the language switcher and select a language.
+- Odoo automatically generates distinct URLs (e.g., example.com/fr_BE)
+