有時看文件會看到像公式一樣的語法像這樣: http://api.jquery.com/jquery/#jQuery1
jQuery( selector [, context ] )
常常看到這個語法在 "用法"、"Syntax" 這樣的標題或標籤附近出現。但是用這個關鍵字範圍太廣泛了。
雖然通常可以意會規則,但有時候也會出現令人疑惑的地方: https://webpack.js.org/concepts/entry-points/ 這個例子出現了三種 "string"
entry: {[entryChunkName: string]: string|Array<string>}
另外句法中常常會出現 +
、|
、*
...,我本以為是代表程式語言的判斷句
但似乎應該是正規表達式
後來在 MDN 發現關鍵字 "Formal (形式) Syntax (句法)",看 MDN 寫的解釋,這東西類似規範文件的說明書。在 "Value_definition_syntax" 說明 CSS 属性值定義語法,而這種定義語法算是一種專門語法。 因為這些資訊後來也找到了更多關鍵字 "type Parser"、"Parsing syntax" 可以供之後深究。 還看到一些有趣網站:
YARD 語法解析:YARD 是一個是 Ruby 編程語言的文檔生成工具。它使用戶能夠生成一致,可用的文檔。這個網站可以把 YARD 正式類型語法轉換為普通的英語。是測試您的類型聲明是否意味著您的想法的好方法。