D Language Website Documentation
repository·master·Indexed 18 days ago
https://github.com/dlang/dlang.orgSource code and content for the official D Language website, including language specifications, official documentation, the Programming in D book by Ali Cehreli, and language changelogs.
What's inside dlang.org
- This repository hosts the source files for the official D Language Website. It contains the language specifications, official documentation, and various articles related to the D programming language.
Access D language community resources
masterThe D language ecosystem provides several platforms for discussion, documentation, and issue tracking:
- Bug Tracker: Use the Bugzilla bug tracker archive for reporting and tracking issues.
- Forum: Participate in community discussions via the D Forum.
- Wiki: Access additional community-driven documentation on the D Wiki.
Add a new changelog entry to the pending changelog
masterTo document new features or changes for the D language, add entries to the pending changelog. These entries are automatically copied to
dlang.organd cleared when themasterbranch is merged intostablebefore a new release.Entry Format
Entries should follow a structure similar to this:
- A title (e.g.,
My fancy new feature X). Note: The title must not contain links, as the title itself is rendered as a link. - A long description of the feature.
- Code snippets (e.g., D code using
assert) to demonstrate the change.
My fancy new feature X A long description of the new feature. ------- import std.range; import std.algorithm.comparison; assert([1, 2, 3, 4, 5].padLeft(0, 7).equal([0, 0, 1, 2, 3, 4, 5])); assert("Hello World!".padRight('!', 15).equal("Hello World!!!!")); -------- A title (e.g.,
Preview pending changelog changes
masterIf you have cloned both the
toolsanddlang.orgrepositories locally, you can preview how the pending changelog will look by running the following command from thelanguage-changelogdirectory:make -C ../dlang.org -f posix.mak pending_changelogBuild Ali Cehreli's book
masterTo build the English version of the book, use the
rdmdtool. The generated files will be output to theweb/bookdirectory.rdmd build.dLocate code samples for the Programming in D book
masterThe code samples used throughout the book "Programming in D" (available at http://ddili.org/) are stored in this directory. Each sample is a standalone
.dfile named using a specific convention to map it back to its original chapter and sequence.Naming Convention:
chapterName.N.dchapterName: The name of the chapter file (without the.htmlextension). For example,hello_worldcorresponds tohello_world.html.N: The sequential order of the program within that chapter.
Example:
hello_world.1.dis the first code sample extracted from thehello_world.htmlchapter file.Note on Translations: In some cases, chapter names containing the Turkish word
cozum(meaning "solution") have been translated tosolutionin the file names. For example,unit_testing.solution.2.dis the second program extracted fromunit_testing.cozum.html.