| Thread overview | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
December 17, 2018 This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Well, I am getting back into it: http://dpldocs.info/this-week-in-d/Blog.Posted_2018_12_17.html | ||||
December 18, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Monday, 17 December 2018 at 22:01:07 UTC, Adam D. Ruppe wrote:
> Well, I am getting back into it:
>
> http://dpldocs.info/this-week-in-d/Blog.Posted_2018_12_17.html
Cool. Keep it going!
| |||
December 18, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Monday, 17 December 2018 at 22:01:07 UTC, Adam D. Ruppe wrote:
> Well, I am getting back into it:
>
> http://dpldocs.info/this-week-in-d/Blog.Posted_2018_12_17.html
Fantastic, Adam! Look forward to reading your next posts.
Thanks for everything you've done for the d community.
| |||
December 18, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On 12/17/2018 2:01 PM, Adam D. Ruppe wrote:
> Well, I am getting back into it:
>
> http://dpldocs.info/this-week-in-d/Blog.Posted_2018_12_17.html
Thank you, Adam!
| |||
December 19, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Monday, 17 December 2018 at 22:01:07 UTC, Adam D. Ruppe wrote:
> Well, I am getting back into it:
>
> http://dpldocs.info/this-week-in-d/Blog.Posted_2018_12_17.html
I have been waiting for this!
Thank you Adam for bringing it back. I enjoyed it back when it last ran.
| |||
December 19, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to bauss | On Wednesday, 19 December 2018 at 14:17:53 UTC, bauss wrote: > Thank you Adam for bringing it back. I enjoyed it back when it last ran. You might enjoy looking at the "home" page too: http://dpldocs.info/this-week-in-d/Blog.html links to the old ones, and to the Tip of the Week index from before to quickly skim! | |||
December 19, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | Here's a fun fact about the setup: the files are actually written as D modules. The source code looks like
// just docs: title
/++
Article content
+/
module Blog.Posted_date;
Now, that might seem a little silly, but it provides some interesting advantages (I should have wrote about this in the first article!):
1) I can use adrdox's linking with the same pattern: I can link with the shortcuts to the titles. Similarly, adrdox's navigation can handle it automatically.
2) I can compile them!
It is #2 that is going to be fun. If I want to write some example code in there, I can compile and run it without any copy/paste action. But wait, how do you see the code in the article?
As a documented unittest, of course! And adrdox has two features that extend it: an `// exclude from docs` comment to take boring plumbing lines out of the publication
/++ I can compile and run this as a test, and display it in the article as a complete program the user can copy/paste and run themselves! +/
unittest {
import arsd.terminal;
void main() {
auto terminal = Terminal(ConsoleOutputType.linear);
string line = terminal.getline();
terminal.writeln("You wrote: ", line);
}
main; // exclude from docs
}
And I can embed the unittest somewhere in the text (via a magic `$(EMBED_UNITTEST id)`) instead of just listing them at the end under examples, so make it flow better with the narrative.
It'll be fun to play with this in the future :)
| |||
December 20, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Monday, 17 December 2018 at 22:01:07 UTC, Adam D. Ruppe wrote:
> Well, I am getting back into it:
>
> http://dpldocs.info/this-week-in-d/Blog.Posted_2018_12_17.html
Thanks Adam! I really loved the tips/tricks part in your old TWiD. I've learned quite a bit off of those so thanks again!
| |||
December 20, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Wednesday, 19 December 2018 at 14:24:01 UTC, Adam D. Ruppe wrote:
> On Wednesday, 19 December 2018 at 14:17:53 UTC, bauss wrote:
>> Thank you Adam for bringing it back. I enjoyed it back when it last ran.
>
> You might enjoy looking at the "home" page too:
>
> http://dpldocs.info/this-week-in-d/Blog.html
>
> links to the old ones, and to the Tip of the Week index from before to quickly skim!
I also like the part where explain what you're currently working on.
That's kinda interesting.
| |||
December 21, 2018 Re: This Week in D is back | ||||
|---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On Monday, 17 December 2018 at 22:01:07 UTC, Adam D. Ruppe wrote:
> Well, I am getting back into it:
>
> http://dpldocs.info/this-week-in-d/Blog.Posted_2018_12_17.html
Great work!
| |||
Copyright © 1999-2021 by the D Language Foundation
Permalink
Reply