Click on "Uncle Wheat" above and select "Top/Star Public Account"
Welfare dry goods, delivered as soon as possible
Hello everyone, my name is Wheat. Today, let's talk about how to write technical articles.
I heard a sentence recently, and I think it makes sense - don’t be a slave to traffic, and strive to be a little value output. Therefore, I think it is necessary for us to do some value output, such as writing technical articles.
A few recent phenomena have aroused my thinking.
During the morning rush hour or evening rush hour, when driving on the road, people are frequently blocked. Some people even slammed on the accelerator for the last few seconds of the traffic light, pressed the yellow light and drove past. As everyone knows, the time saved by racing against time on the road may be Brush short videos and squander in a few hours;
Some people buy funds, buy stocks, and finally become leeks. As for why buy it? What did you buy? Do you really want to buy it? It is the flow of information around us that influences our judgment, affects our actions, and subtly changes our thoughts.
Trapped in the quagmire of information, it becomes increasingly difficult to think independently. Shouldn't it be time to think about it and output something?
I usually write some technical notes to settle the problems I encounter on weekdays. As for blogging for a while, I tried to output on the platform of the official account.
When writing a blog, you can usually choose to host it on the corresponding blog platform, or build your own personal blog to write;
If it is a blog platform, you can usually choose: csdn, cnblogs, 51cto, Zhihu,
If you build a personal blog by yourself, it is relatively cumbersome; you need to rent a server, file a domain name, and wordpressuse it. The detailed process can be searched by yourself.hexoJekyll
Of course, the official account can also write articles, but the overall is not very friendly;
One is that the editor is not very friendly; the other is that the article cannot be modified after it is pushed to the readers. At present, 20 words can be modified, and it can be modified once, which is not conducive to the iteration of the article.
However, the public account has added the function of publishing, you can try it and solve a problem.
A friend also asked me if I had a tutorial on writing a public account;
Below I will briefly share the experience of writing public accounts. Since I basically write some technical articles, the following are some of my insights and experiences on the output of technical articles. The space is limited, so let's keep it short.
1 preparatory part
First of all, we have to register a public account, which is divided into 服务号and 订阅号, what is the difference?
The service number is sent once a week, and it can directly appear in the WeChat message list, as shown below;
The subscription account can be sent once a day, and it will appear in the subscription account message list. Because there are many official accounts, it will be folded, as shown below;
Here I suggest registering a subscription number directly, which is more convenient, and the frequency of publishing articles is relatively high.
After registration, what is the positioning of the content we want to create? What is the content of the field? How to name the official account? This article will not introduce such issues, and focus on the following aspects of content creation.
2 Create an article
This is a question I saw on Zhihu a long time ago. The following answers have benefited me a lot. Although the question is about popular science articles, technical articles are actually quite similar to popular science articles.
Before writing the article, we need to think about a few questions:
What is the purpose of writing this article?
Who are you writing to?
What do we want our readers to get?
What is the purpose of writing an article? If the purpose is to get more reading, then the writing is easy to understand, and the content is simple and straightforward.
If the articles written are very in-depth, they are often high and low, and they cannot be read well; the two are often incompatible.
Who are you writing to? That is, the audience of the article determines the style of the article, whether it is easy to understand, whether it can be explained from the reader's point of view, and whether it can be understood by the reader, are all issues to be considered.
What do you want readers to get? Not only learned the knowledge, but also gained the liveliness and humor of the article, which is often difficult, and the author needs to work hard on the article.
Here are some of my views, and we'll go into more detail below.
2.1 Audience
Who is it written for? Who is the audience for the article?
The novice who has not yet started;
is a newbie;
or already experienced practitioners;
One article can't be suitable for everyone, so if it doesn't work, write a few more.
After determining the audience, we decide what style we should use to write this article.
If the readers are novices, then the whole article should be written in extremely easy-to-understand language. You may have heard of the Feynman method of learning, explaining a topic of knowledge to a novice so that he can fully understand it.
There are a few points involved here;
Explain in words that he can fully understand, try to be as simple as possible;
Use less terms and concepts, because you may understand a concept, although only a few words, but others may spend a lot of time to understand it;
During the whole process, we will do a review on this topic, and then during the explanation process, we may get stuck on some concepts. I've relearned and understood these concepts while fully teaching others, and it's a win-win.
2.2 Half of a good question
How to start a good title, talk about personal views, the title should try to highlight the theme and general content of the article. Common header methods are these:
Straight to the point: share a practical xxxx
The title sets the suspense; you don't know what's behind xxxx, it's actually...
Set clear goals; one article teaches you to understand xxxxx
Contains data; 30000 pieces tell you, xxxxx
Reverse thinking; how about xxxx, but xxxx?
Of course, in addition to the above, there are also many headline styles. In addition to observing how 100,000+ large-sized titles are usually created, they should also think more and summarize in combination with practice. The last thing is to observe more, the preferences of your readers.
The above are some of my views on the title of the article, let's talk about the text below.
2.3 Text
Because it is a technical article, the text must be clear and logical, which is the most basic. You can try to write in a practical pyramid thinking mode.
Begin by giving a very simple statement to give your conclusion, or the main idea of the article as a whole. In order to support this conclusion, it will be demonstrated from various aspects later. I believe that after doing so, the overall structure of the article will be clearer. If you are interested, you can read the book "The Pyramid Principle".
Next, we must continue to practice. Writing also requires a lot of practice, a lot of accumulation, reading thousands of volumes, and writing like a god.
After you have the first draft, you still need to keep polishing the article, revising it, and optimizing it. As mentioned earlier, the public account is not conducive to revision, which is also a drawback.
In addition, it is necessary to combine pictures and texts. Where there are some data support, it will be more intuitive to use the form of charts, and some programs may be more intuitive to use pseudocode or flow charts.
3 Efficiency Tools
3.1 Writing
There are many tools for writing articles, such as word, wps, or 文本编辑器, recommended here is practical typora, this software has begun to charge, but version 0.11.18it is still free to download the historical version from the official website.
My configuration steps are like this;
Download a Mango cloud locally as a file synchronization;
to
Typorawrite articles;Insert a picture,
Typoraset it to upload to the server in , and it will be automatically called herePicGoto upload;It needs to be installed
PicGo, and you also need to configure the image bed (that is, the place where the image is saved in theGitHubcloudGitee)COS.
3.2 Drawing
We talked about the combination of pictures and texts above. Sometimes a picture leaves a thousand words. Now I will introduce some drawing tools that can be used;
matlab
In spwmthe article I wrote, in order to introduce the unipolar regular sampling method, I used a matlabpicture of half a cycle, as shown in the following figure;
draw.io
draw.io is a multi-functional drawing software, open source and free. It is compatible with Microsoft's Visio. It can draw flowcharts, organizational charts, etc.; the following is a diagram I drew when I wrote an article on SPI;
geogebra
This is a mathematical drawing software that can convert complex mathematical formulas into intuitive pictures, and also supports animation effects. The following is a animation drawn by this software;
3.3 Typesetting
Finally, when it comes to typesetting, there are many plugins and tools that can make typesetting more effective; briefly talk about my typesetting method;
typoraWrite the article first ;Then copy it to
mdnicea typesetting that can be converted into a page style that conforms to the official account;
In addition markdownto typesetting, there are many plug-ins, such as 135 editor, beauty editor, one companion plug-in, etc., which can be used for rapid typesetting, greatly improving efficiency.
4 Summary
This article simply shares some experience with the original image and text of the official account. The length is relatively short, and only a brief introduction is given in many places, which is only for your reference. Easier said than done, writing requires persistence and constant practice, I believe that quantitative changes will bring qualitative changes.
In the end, we have to start doing something calmly, and once we start, we must persevere to the end. If the article is helpful, please like it and forward it to help more people.
—— The End ——
Recommended in the past
7 C programs summarized in actual combat, good things are not hidden
Demystifying, how complicated is embedded OTA technology?
Do not look sorry! 18 embedded C practical experience summed up by veterans in the circle
Join the embedded technology exchange group and make progress together
Click on the card above to follow me
Everything you ordered looks good , I take it seriously as I like it