返回 Skill 列表
extension
分类: 开发与工程无需 API Key

frago-view-content-generate-tips-code

代码文件内容生成指南。当您需要创建可通过`frago view`预览的代码文件时,请使用此技能。涵盖支持的语言、主题选择和最佳实践。

person作者: jakexiaohubgithub

Code File Content Generation Guide

Preview code files via frago view with automatic syntax highlighting.

Preview Commands

frago view script.py                      # Default theme
frago view script.py --theme monokai      # Specify theme

Supported File Types

| Extension | Language | highlight.js Tag | |--------|------|------------------| | .py | Python | python | | .js | JavaScript | javascript | | .ts | TypeScript | typescript | | .jsx | JSX | javascript | | .tsx | TSX | typescript | | .css | CSS | css | | .scss | SCSS | scss | | .html | HTML | html | | .json | JSON | json | | .yaml / .yml | YAML | yaml | | .toml | TOML | toml | | .xml | XML | xml | | .sql | SQL | sql | | .sh / .bash | Bash | bash | | .go | Go | go | | .rs | Rust | rust | | .java | Java | java | | .c / .h | C | c | | .cpp / .hpp | C++ | cpp | | .rb | Ruby | ruby | | .php | PHP | php | | .swift | Swift | swift | | .kt | Kotlin | kotlin | | .lua | Lua | lua | | .r | R | r | | .txt | Plain Text | plaintext |


Code Themes

| Theme | Style | Use Case | |-------|-------|----------| | github-dark | GitHub Dark (default) | Daily use | | github | GitHub Light | White background preference | | monokai | Monokai Classic | Developer preference | | atom-one-dark | Atom Dark | Modern style | | atom-one-light | Atom Light | Light preference | | vs2015 | Visual Studio | Windows style |

# Preview with different themes
frago view main.py --theme monokai
frago view config.yaml --theme atom-one-dark

Best Practices

1. File Encoding

  • Must use UTF-8 encoding
  • Avoid BOM header
  • Use LF line endings (Unix style)

2. Line Length

  • Single line no more than 120 characters
  • Very long lines will be truncated on display

3. Comment Guidelines

# Single-line comments should be clear and concise

"""
Multi-line comments used for:
- Module documentation
- Function documentation
- Complex logic explanation
"""

4. Code Structure

  • Group logic with blank line separation
  • Two blank lines between functions/classes
  • Group related imports

Display Features

Automatic Line Numbers

Code preview automatically displays line numbers for easy reference.

Syntax Highlighting

Based on highlight.js, automatically recognizes language and highlights:

  • Keywords
  • Strings
  • Comments
  • Numbers
  • Function names
  • Class names

Style Reference (github-dark)

| Element | Color | |---------|-------| | Background | #0d1117 | | Text | #c9d1d9 | | Keywords | #ff7b72 | | Strings | #a5d6ff | | Comments | #8b949e | | Functions | #d2a8ff | | Numbers | #79c0ff |


Notes

| Issue | Cause | Solution | |-------|-------|----------| | No syntax highlighting | Extension not recognized | Use standard extensions | | Chinese garbled text | Encoding issue | Ensure UTF-8 | | Truncated display | Line too long | Control line length | | Slow rendering | File too large | Split or simplify |


Use Cases

  • Code snippet display
  • Configuration file preview
  • Script review
  • Code sharing

Not suitable for: Complete source code of large projects (recommend using IDE)