|
OriginalGriff wrote: I still end up with the online editor.
But Word has one big advantage
Or two, maybe: The article's still there if a rugrat chews through your Ethernet cable.
I wanna be a eunuchs developer! Pass me a bread knife!
|
|
|
|
|
0x01AA wrote: How you would structure this?
Start with everything you want to talk about, put it into an outline of topics/sub-topics.
Start writing either linearly or the parts that you're drawn to first.
As you're writing, update the outline and see how things begin to evolve -- is it getting too long, is there a natural break for a couple articles evolving? Prune stuff that becomes irrelevant or you don't want to deal with.
0x01AA wrote: Should I use the online editor
No - although it's evolved a lot, like being able to save drafts, I find online editing of anything to be a PITA, with the exception of lounge posts, haha. I'm an old fart, so believe it or not, I'm still using FrontPage 2003 for editing. Find a decent HTML editor (harder than it looks, maybe someone can make some recommendations here) that can let you do a split screen of the markup and the WYSIWYG. Write it all offline.
Hint to save you pain: images go in the same folder as wherever your "article.html" is, as image references in CP are now (and have been for quite a while, but it was not always so) "local".
Other hints:
- Main topic headers are H2
- Use bold and italic sparingly
- variable names, methods, etc., in the text should be wrapped with code tags
- code blocks are wrapped in pre tags
- watch your image size, CP likes images no bigger than, um, 600 width (I think) which I violate constantly. One cool technique for really big images is to put upload both a small and a 100% image, and add a link to the 100% image, like "click here for full size image."
- Personally, I like small code blocks. Don't throw a 500 line class at me, break it into individual method code blocks, in between explain what each method does and why (why is sooo important), etc.
More hints: A Guide To Writing Articles For Code Project
Something I've seen people start doing which I really like is a section at the top of the article on "what you will learn", which is cool, because even if I have no interest in a C-like <1% parser, I might be really interested in how EBNF works and other cool geeky things you are covering.
Marc
Latest Article - Merkle Trees
Learning to code with python is like learning to swim with those little arm floaties. It gives you undeserved confidence and will eventually drown you. - DangerBunny
Artificial intelligence is the only remedy for natural stupidity. - CDP1802
|
|
|
|
|
Visual Studio, no honestly.
|
|
|
|
|
Jörgen Andersson wrote: Visual Studio, not honestly.
FTFY!
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
|
|
|
|
|
Oh come on, he's using Frontpage ffs.
Make a better suggestion instead.
|
|
|
|
|
Thank you very much for this.
Quote: Something I've seen people start doing which I really like is a section at the top of the article on "what you will learn",
A very good tip. The main Thing should be to Point out the way from EBNF to Wizard and how "intermediate" results of this are connected to the Parser stuff. While writing just the sentence before, I have a Feeling that one of the bigger problems will be my english.
Bruno
modified 19-Jan-21 21:04pm.
|
|
|
|
|
Sorry to disturb, please feel free not to answer 
What do you think about this Basic layout for the article:
Content
^Introduction
^What you will learn
^Prerequisites
^What is a Parser
^What is EBNF (Extended Backus–Naur form)
^EBNF to data structure
^From EBNF to wizard
^Using the code
:Introduction
This article tries to point out how a simple programming language can be defined by a meta language like EBNF (Extended Backus–Naur form) and how a parser and - the main aspect here- a wizard can be build based on such a meta definition.
Since the whole topic is very wide, we will concentrate here on the theme "From EBNF to Wizard". The also very intersting part to develop a CompilerCompiler (CoCo) is addressed in a minor way. Minor, because you can find a lot about CoCo in www e.g.
- https://www.codeproject.com/Articles/343646/Mathematical-Expression-Parser-Using-Coco-R
- .... TODO much more
:What you will learn
How to create a wizard for a formal defined "programming language" - defined e.g. by a meta language like EBNF.
:Prerequisites
It is an advantage if you allready have some basics knowledege about parsing (lexical analysis, syntacticals analysis, semantic analysis) and also some knowledge about EBNF.
In case you are familar with this stuff you can skip the next two sections and proceed with ^EBNF to data structure
:What is a Parser in short
Keep in mind, this is a very abreviated introduction.
The job of parsing a text can be splitted into three Jobs:
1. Lexcial Analysis
2. Syntactical Analysis
3. Semantic Analysis
While https://de.wikipedia.org/wiki/Compiler#Lexikalische_Analyse does describe these three points togehter (english wiki not) I feel free to translate and summarize them here instead of giving links to wiki:
TODO
:What is EBNF (Extended Backus–Naur form)
TODO
:EBNF to data structure
TODO
:From EBNF to wizard
TODO, the big part here
:Using the code
::Some notes about the code
The code is far away to be optimal or ready for production. Also it will break a lot of times SOLID principles. Why I'm doing it like this:
The main target is to show in a very easy/direct way the relations of the involved aspects, without hiding the essentials by using over engineered code.
Also the code is originally developed with Embarcadero Studio in c++ and to be more up to date I migrated all the stuff to c#
:Points of Interest
TODO
:History
V#.# Inital release yyyy/mm/dd
BTW: I decided to write the very first Version in a simple text Editor - no Pictures etc. - to be sure I concentrate on the content/text.
Bruno
modified 19-Jan-21 21:04pm.
|
|
|
|
|
No problem. The outline is great. Something my readers have commented that they liked, which you elude to with the section on "some notes about the code" is some light (and lighthearted) discussion of the compromises, rabbit holes, and other things I did (including the wrong ones) that I discovered along the way.
BTW, if you'd like me to proofread anything (regarding your concern about English) I'd be happy to offer my editing services.
Also, there's this Table of Contents generator that I use for large articles. It has a couple bugs (no symbols in the headers, and popping two levels breaks further link generation) but otherwise it's a solid tool and there's some comments about how to fix those bugs in the article itself.
Marc
Latest Article - Merkle Trees
Learning to code with python is like learning to swim with those little arm floaties. It gives you undeserved confidence and will eventually drown you. - DangerBunny
Artificial intelligence is the only remedy for natural stupidity. - CDP1802
|
|
|
|
|
Thanks a lot again for your help.
Proofread anything:
I really appreciate to accept your offer, I allready ask @OriginalGriff to help me on this. Maybe another expirience for me to see the differences between britan and us english... I assume I will see similar (but hopefully easier differences) things compared to when I have to translate EU-Spanish to Argentina/Colombia/Equador/Salvador/Equador/Honduras  
Bruno
modified 19-Jan-21 21:04pm.
|
|
|
|
|
0x01AA wrote: I allready ask @OriginalGriff to help me on this.
Awesome!
Marc
Latest Article - Merkle Trees
Learning to code with python is like learning to swim with those little arm floaties. It gives you undeserved confidence and will eventually drown you. - DangerBunny
Artificial intelligence is the only remedy for natural stupidity. - CDP1802
|
|
|
|
|
![Rose | [Rose]](https://codeproject.global.ssl.fastly.net/script/Forums/Images/rose.gif) You might want to try CodeProject.Show, an offline article writer for CodeProject developed by Anele Mbanga. The link is to the CodeProject article which includes source code and installer for the Show app.
In Anele's words,
Quote: The purpose of this article is to introduce CodeProject.Show, an offline CodeProject article writer. CodeProject.Show has been developed using WinForms, ICSharp.TextEditor and the Webbrowser control using VB.Net. I started developing this five days ago to enable me to write my CodeProject articles offline. This was due to internet connectivity issues at times being erratic and also me loosing an article due to these internet challenges. I also wanted to ensure that I kept track of my articles and are able to update them in one place.
Good luck! 
Remain Calm & Continue To Google
|
|
|
|
|
Thank you, I will have a look to it.
modified 19-Jan-21 21:04pm.
|
|
|
|
|
Eating his pizza before it was cool.
I'll get me coat.
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
|
|
|
|
|
 Your coat, your hat, and your self have been deposited outside the Lounge.
If you have an important point to make, don't try to be subtle or clever. Use a pile driver. Hit the point once. Then come back and hit it again. Then hit it a third time - a tremendous whack.
--Winston Churchill
|
|
|
|
|
And, of course, it was vegan, gluten-free pizza.
|
|
|
|
|
I share an avatar with Mark_Wallace, Mark Clifton and possibly others. Not good. I wanna be exclusive!
Get me coffee and no one gets hurt!
|
|
|
|
|
Now we have it: A stall full of little princesses. 
The language is JavaScript. that of Mordor, which I will not utter here
This is Javascript. If you put big wheels and a racing stripe on a golf cart, it's still a f***ing golf cart.
"I don't know, extraterrestrial?"
"You mean like from space?"
"No, from Canada."
If software development were a circus, we would all be the clowns.
|
|
|
|
|
I'm just posting to see what I get!
Edit:
SWEETCREAM SCOOPS
SWEETCREAM SCOOPS loves to sing more than anything! She can even reach the really high notes!
modified 1-Apr-17 9:39am.
|
|
|
|
|
I have a BIG pair of pliers, if you want to practice and need help?
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
|
|
|
|
|
That would not help anymore. You are a few years too late.
The language is JavaScript. that of Mordor, which I will not utter here
This is Javascript. If you put big wheels and a racing stripe on a golf cart, it's still a f***ing golf cart.
"I don't know, extraterrestrial?"
"You mean like from space?"
"No, from Canada."
If software development were a circus, we would all be the clowns.
|
|
|
|
|
The pliers will still help him reach the high notes!
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
|
|
|
|
|
Strange. It says "professional", but it really doesn't sound like that... 
Anything that is unrelated to elephants is irrelephant
Anonymous
-
The problem with quotes on the internet is that you can never tell if they're genuine
Winston Churchill, 1944
-
I'd just like a chance to prove that money can't make me happy.
Me, all the time
|
|
|
|
|
Initially I was dismayed to discover that some members here knew that Maunder had inflicted us with My Little Ponies avatars. But now I understand some of these members know the names of said Ponies.
I thought Maunder had just ran some of his selfies through a Meme generator.
Michael Martin
Australia
"I controlled my laughter and simple said "No,I am very busy,so I can't write any code for you". The moment they heard this all the smiling face turned into a sad looking face and one of them farted. So I had to leave the place as soon as possible."
- Mr.Prakash One Fine Saturday. 24/04/2004
|
|
|
|
|
Right click, "Search Google for image", Princess Celestia!
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
|
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
