32
41
Fork
You've already forked website
53

Document double-square bracket syntax #165

Closed
opened 2023年03月07日 19:35:57 +01:00 by Ryuno-Ki · 4 comments
Contributor
Copy link

This is a comment from #153 (comment)

[[ something ]] is a syntax we should explain. Is it something from Go template?
(I doubt it). Markdown? (Not that I know of) Gitea/Forgejo? Something else?

Where is the authorative source that explains it?

This is a comment from https://codeberg.org/forgejo/website/pulls/153#issuecomment-827221 `[[ something ]]` is a syntax we should explain. Is it something from Go template? (I doubt it). Markdown? (Not that I know of) Gitea/Forgejo? Something else? Where is the authorative source that explains it?

Here the link to implementation comment:

// MediaWiki uses [[link|text]], while GitHub uses [[text|link]]
// It makes page handling terrible, but we prefer GitHub syntax
// And fall back to MediaWiki only when it is obvious from the look
// Of text and link contents
Here the link to implementation comment: https://codeberg.org/forgejo/forgejo/src/commit/443f7d59f9606a9ec3ba331cd23d9675aa45c471/modules/markup/html.go#L655-L658

Alternative links with [[...]]

  • [[Link label|README.md]] → Link label
    • Note: different from MediaWiki syntax where it would be [[README.md|Link label]]
  • [[README.md]] → README.md
  • [[Forgejo's README|README.md|alt=Learn more about Forgejo]] → Forgejo's README

Maybe this could be also an additional section to https://docs.codeberg.org/markdown/using-links/

#### Alternative links with `[[...]]` - `[[Link label|README.md]]` → [[Link label|README.md]] - Note: different from MediaWiki syntax where it would be `[[README.md|Link label]]` - `[[README.md]]` → [[README.md]] - `[[Forgejo's README|README.md|alt=Learn more about Forgejo]]` → [[Forgejo's README|README.md|alt=Learn more about Forgejo]] Maybe this could be also an additional section to https://docs.codeberg.org/markdown/using-links/
Contributor
Copy link

I agree that it belongs in https://docs.codeberg.org/markdown/using-links/

I agree that it belongs in https://docs.codeberg.org/markdown/using-links/

OK, close it here. Forgejo itself should maybe have these kind of pages, but that is another story.

OK, close it here. Forgejo itself should maybe have these kind of pages, but that is another story.
Sign in to join this conversation.
No Branch/Tag specified
main
monthly-2026-05
mahlzahn-eslint-js
preview-link-status
nightfire
2022年12月14日-main
No results found.
Labels
Clear labels
404
Broken links or missing content
Accessibility
Accessibility
Blog post
Documentation
Forgejo Documentation
Internationalisation
i18n and l10n
User research - Accessibility
Requires input about accessibility features, likely involves user testing.
User research - Blocked
Do not pick as-is! We are happy if you can help, but please coordinate with ongoing redesign in this area.
User research - Community
Community features, such as discovering other people's work or otherwise feeling welcome on a Forgejo instance.
User research - Config (instance)
Instance-wide configuration, authentication and other admin-only needs.
User research - Errors
How to deal with errors in the application and write helpful error messages.
User research - Filters
How filter and search is being worked with.
User research - Future backlog
The issue might be inspiring for future design work.
User research - Git workflow
AGit, fork-based and new Git workflow, PR creation etc
User research - Labels
Active research about Labels
User research - Moderation
Moderation Featuers for Admins are undergoing active User Research
User research - Needs input
Use this label to let the User Research team know their input is requested.
User research - Notifications/Dashboard
Research on how users should know what to do next.
User research - Rendering
Text rendering, markup languages etc
User research - Repo creation
Active research about the New Repo dialog.
User research - Repo units
The repo sections, disabling them and the "Add more" button.
User research - Security
User research - Settings (in-app)
How to structure in-app settings in the future?
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
forgejo/website#165
Reference in a new issue
forgejo/website
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?