documentation-website icon indicating copy to clipboard operation
documentation-website copied to clipboard

[Jekyll] Speed up the HTML rendering process

Open nhtruong opened this issue 1 year ago • 1 comments

Right now if you run jekyll serve. It takes 4 to 5 minutes before the site is served at localhost:4000, and it takes just as long for any changes to the MD files to be reflected on the site. I even tried the experimental incremental generation feature but it didn't help.

When running jekyll build --profile you will get:

Site Render Stats: 

| Filename                                                                        | Count |      Bytes |    Time |
+---------------------------------------------------------------------------------+-------+------------+---------+
| _layouts/default.html                                                           |  1002 | 310975.33K | 259.707 |
| _includes/nav.html                                                              | 21330 | 206812.18K | 118.607 |
| jekyll-remote-theme-20241029-77643-fg5leb/_includes/head.html                   |  1004 |   2524.66K | 117.116 |
| jekyll-remote-theme-20241029-77643-fg5leb/_layouts/vendor/compress.html         |  1004 | 245470.92K |  11.344 |
| _includes/header.html                                                           |  1004 |  25048.17K |   2.815 |
| _includes/toc.html                                                              |  1002 |    472.12K |   1.943 |
| jekyll-remote-theme-20241029-77643-fg5leb/_layouts/table_wrappers.html          |  1004 | 311141.78K |   1.210 |
| _includes/footer.html                                                           |  1004 |  28332.61K |   0.289 |
| _includes/head_custom.html                                                      |  1004 |    225.45K |   0.158 |
| _layouts/home.html                                                              |     1 |     58.74K |   0.120 |
| _layouts/search_layout.html                                                     |     1 |     64.33K |   0.103 |
| sitemap.xml                                                                     |     1 |    140.64K |   0.064 |
| jekyll-remote-theme-20241029-77643-fg5leb/_includes/footer_custom.html          |  1002 |      0.00K |   0.023 |
| _includes/feedback.html                                                         |  1002 |   1478.06K |   0.022 |
| jekyll-redirect-from-0.16.0/lib/jekyll-redirect-from/redirect.html              |   621 |    375.16K |   0.019 |
| assets/js/zzzz-search-data.json                                                 |     1 |      2.41K |   0.015 |
| _includes/copy-curl.html                                                        |  2175 |    106.20K |   0.014 |
| _security/access-control/permissions.md                                         |     1 |     32.99K |   0.008 |
| _dashboards/dashboards-assistant/index.md                                       |     1 |      8.50K |   0.006 |
| _ingest-pipelines/processors/html-strip.md                                      |     1 |      4.79K |   0.006 |
| _install-and-configure/install-opensearch/tar.md                                |     1 |     29.19K |   0.004 |
| _includes/copy.html                                                             |   626 |     27.51K |   0.003 |
| _security/access-control/api.md                                                 |     1 |     46.54K |   0.003 |
| _dashboards/management/multi-data-sources.md                                    |     1 |     23.42K |   0.003 |
| _dashboards/visualize/viz-index.md                                              |     1 |      9.54K |   0.003 |
| index.md                                                                        |     1 |      2.06K |   0.003 |
...

The bulk of the processing time comes from rendering _layouts/default.html , _includes/nav, and their dependencies, especially the files from jekyll-remote-theme plugin. We should into these components see if there's a way to optimize them.

nhtruong avatar Oct 30 '24 21:10 nhtruong

[Catch All Triage - 1, 2, 3, 4, 5]

andrross avatar Nov 18 '24 17:11 andrross

Closing as stale

natebower avatar Jul 14 '25 19:07 natebower