Conversation
Every page of these mutations now holds a {{redirect: en:name}} directive,
from which the web builds a permanent redirect, so backlinks and search
indexing carry over to the English page instead of being thrown away. Menu
and @meta files are deleted outright, having no URL of their own.
Together they accounted for 804 engaged sessions a year out of 33 604, that
is 2.4 percent of real documentation traffic; between 90 and 97 percent of
their visits showed no engagement at all. Reasoning and data are in
_tools/docs/0001-redukce-jazykovych-mutaci.md.
Texy produces the right pair for the page locale, so the source only ever needs
", ' and -. Hand typed characters kept producing broken pairs such as „text"
that nothing reported, and in a mutation they stayed in the shape of a foreign
language even where Texy would have made another one.
The en dash conversion is invisible in the output: Texy makes it again from a
hyphen between spaces or digits. What does disappear are the em dashes, 14 of
them, and where one stood between words with no spaces, spaces were added so it
would not turn into a hyphen.
Two cases changed on purpose beyond that: key-value and test- now use a hyphen,
which is what belongs there, and a Czech quote pair typed by hand into an
English page in migrations now renders with English quotes.
Also protected the --watch flag in tester with backticks. Outside backticks
Texy reads the two hyphens as a dash, so the page documented a flag spelled
with a dash.
Code blocks, inline code and ''raw'' are left alone, and so are the values of
{{maintitle}} and {{description}}, which are printed verbatim: there a dash
would vanish from the output too, and that calls for rewriting the sentence.
Verified by rendering every changed page through Texy 3.2.8 before and after:
8225 lines identical, 38 differing only in typography, no structural change.
Line counts and language alignment are untouched.
…ette#1079) Incorporates the docs from nette#1079, verified against the plugin's "added host option and normalized dev server URL" change: host option, 0.0.0.0/true normalization to localhost, CORS/allowedHosts handling.
Upgrade notes used to live in one global migrations/ directory, mixed across all packages, while database/ and utils/ already carried their own upgrading.texy. This consolidates everything on the per-package model, so the notes sit next to the package they describe. - add upgrading.texy to 15 packages (cs+en), sections ordered from the newest version down to the oldest - migrations/ becomes a lightweight hub: how to upgrade + links to the per-package pages; the migrations: URL keeps working - drop the pre-componentization guides (2.0-2.2). Nette split into separate packages in 2.2, so per-package notes start at 2.3 - drop the balast: minimum PHP versions, composer.json version blocks, composer-frontline.php and the cosmetic I-prefix interface renames - use the term "upgrading" rather than "migration"; migration now only means switching technology, as in Latte's cookbook - link Upgrading from the packages' left menus
… and Security First
Fifteen sections had no menu of their own and borrowed nette:@menu-topics or www:@menu-common, so their pages were unreachable from the navigation. Each of them now has its own @left-menu.texy, and every menu on doc.nette.org ends with a Further Reading group, so none of them leads only inwards. The main topics list moved from nette/@menu-topics into the nette left menu, where the whole section shows it instead of just Configuring. Its cs and en copies are deleted, the other languages keep theirs until they are retranslated. Also listed the five Latte extension pages that were reachable only from prose.
The web application used to suppress the left menu on the homepage of
every subdomain book, which also hit ai.nette.org and texy.nette.info,
where the menu is wanted. Suppression is now explicit here instead: the
landing pages of nette.org, doc.nette.org, Latte, Tracy, Tester and Dibi
carry {{leftbar: no}}, and any homepage without it shows its menu.
The directive is language neutral and the translator never touches its
value, so it is added to all languages at once to keep the landing pages
consistent until the next translation run.
In the left menu of both sections, and in the places where the course continues the text. Replaces the link to the archived di-example-doc.
…t: network, glob entries)
Adds sections for Expect::enum(), description() and the JSON Schema export, notes that before() handlers now chain instead of replacing one another, and mentions the deprecation notice raised when pattern() or items() is attached to an element of a different kind. The Custom Schema Elements example no longer builds an EnumSchema by hand, since Expect::enum() now does exactly that; it validates byte sizes instead.
dg
force-pushed
the
master
branch
2 times, most recently
from
September 18, 2026 14:52
8aadbc2 to
ea262d2
Compare
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
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.
Adds Latte+ to the list of PhpStorm plugins.
tools/*/ide.texylists the Latte plugins for PhpStorm,latte/*/recipes.texymentions one of them; Latte+ is added in both places. Czech and English are included, per the documentation contributing rules.Latte+ is a Latte plugin for PhpStorm released in September 2026. It covers syntax and PHP completion in templates,
{include}/{embed}parameter completion, typed templates including generics, navigation to templates and blocks, inspections and formatting.Disclosure: I am the author of the plugin.