expressjs/expressjs.com

Res.Render documentation missing information.

Open

#1,457 opened on 2024年1月29日

GitHub で見る
 (1 comment) (0 reactions) (0 assignees)CSS (5,330 stars) (2,088 forks)batch import
docshelp wanted

説明

I cannot find any information anywhere in the documentation or of other sources where res.render pulls the HTML from that we are referencing in the documentation.

For example, I want to render some HTML (preferably in a file somewhere) and inject some variables into it. In the photo below at docs we are stating 'email'.

image

  • Does this mean email.html in the same directory as this .js script?
  • Does this mean we previously read the file email.html and read it into memory somewhere?

I have been trying to understand this process of express and utilize this function but everyone just glances over this part in particular.

So. where is the html for email?

コントリビューターガイド

技術スタック
javascriptnodejsexpress
領域
documentation
Issue 種別
documentation
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
3
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
1-3 hours
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
fresh
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
basic Express usage
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
70
調査方針
The issue requests clarification on how res.render works in Express documentation. The user is confused about where the template file (e.g., email.html) is located. The documentation at https://expressjs.com/en/api.html#app.render should be updated to explain that res.render uses the view engine and requires setting up a views directory. Refer to the Express guides on using view engines. No linked PRs or comments provide additional direction. The maintainer should provide a clear explanation and update the API docs accordingly.