Re: This Week in D is back
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!
Re: This Week in D is back
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.
Re: This Week in D is back
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!
Re: This Week in D is back
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 :)
Re: This Week in D is back
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!
Re: This Week in D is back
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.
Re: This Week in D is back
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!
Re: This Week in D is back
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.
Re: This Week in D is back
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!
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
