algolia / algolia/jekyll-algolia

How are the pages compiled?

Open
#125 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Ruby
Stars
211
Forks
35
PR merge metrics
No merged PRs in 30d

Description

Hi, I've got a question. When compiling my pages, the plugins seem to build only one `

` and put everything inside with `\n\n` to separate paragraphs.

For [this page](https://boris.schapira.dev/en/about/site/), here's the built data:

```
"html": "

I am the main author and the only person responsible for the contents published\non this site. On the other hand, the brands mentioned on this site are the\nproperty of the companies that have registered them. This entire site is subject\nto French law.\n\nThe views and opinions expressed on this blog are mine only, and in no way those\nof my employers or clients, my hosting provider or any other entity or\nindividual.\n\n
```

I wonder: where does that difference comes from? Is this because [I use CommonMark](https://github.com/borisschapira/boris.schapira.dev/blob/master/_config.yml#L177) for my compilation? What does the plugin use to build the page?

Contributor guide

Open the contributing guide

Research direction

Start with the CommonMark setting at _config.yml#L177 and compare it with the built data from the linked about page. Trace how the plugin handles that page's HTML and determine whether the paragraph difference comes from CommonMark or the plugin. Done means documenting the cause and identifying which component produces the output.

Written by the indexing model from the issue text.

Assessment

Tech stack
jekyll, ruby
Domain
search
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.