[枚举]认领“Enumerations 枚举”一章的翻译 #50
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
非常感谢！ |
chenranj
pushed a commit
that referenced
this pull request
Apr 8, 2025
This reduces the places where content in the comment causes DocC to
silently mis-parse the comment and content after it.
The markdown parser for DocC first parses plain markdown syntax, and
then identifies places where the `@Comment { }` syntax delimits blocks.
That means it tries to parse the content of a comment as markdown first,
and then later it gets turned into a comment. The parsing of HTML style
comments happens as part of the first stage, which makes it less
fragile.
Using the DocC syntax for comments, a lot of the issues seem to come
from `}` appearing in commented-out in code listings, or from other
places where part of the comment is being interpreted as markdown and
preventing the later DocC parsing pass from treating that content as a
comment, or in some causes causing content after it to be missing. Using
the HTML comment syntax, the `-->` arrow used in comment-out formal
grammar conflicts with the end-of-comment marker, which I worked around
by changing them to a `->` arrow. We can probably delete most or all of
the commented-out formal grammar blocks, which seem to date back to the
original drafting of the book's grammar.
Some of the comment-parsing issues appear to be related to a known issue
in Swift-Markdown: swiftlang/swift-markdown#84
chenranj
pushed a commit
that referenced
this pull request
Apr 8, 2025
chenranj
pushed a commit
that referenced
this pull request
Apr 8, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
[枚举]申请认领“Enumerations 枚举”一章的翻译，已翻译2个小节。