Standards zum Schreiben von Codekommentaren bei der Webseitenerstellung

Standards zum Schreiben von Codekommentaren bei der Webseitenerstellung
<br />Ich habe die in meiner Arbeit verwendeten Standards zum Schreiben von Anmerkungen zusammengefasst. Es gibt keinen technischen Inhalt, sie dienen lediglich dazu, die Produktionsmethode zu vereinheitlichen und die Wartung zu erleichtern. Es umfasst vier Teile: „ Regionale Kommentare “, „ Einzeilige Kommentare “, „ Kommentarebenen “ und „ Unterstützte Kommentare “.
Die meisten Schüler verwenden die Methode der Bereichsanmerkung, die mit „Anmerkungsinhalt beginnt“ oder „Anmerkungsinhalt endet“, „Start“ oder „Ende“ usw. beginnt. Im Vergleich dazu kann der Beginn mit „S“ oder „E“ schneller verwendet werden. Sie müssen beispielsweise den Start- oder Endkommentar nur einmal schreiben, ihn dann kopieren und „S“ oder „E“ ändern, um die Bereichsanmerkung schnell abzuschließen.
Bereichsanmerkung <br />Bei der tatsächlichen Arbeit ist es manchmal unklar, ob die Anmerkung über oder unter der Beschriftung stehen soll. Um diese Situation zu vermeiden, werden die Anmerkungsinformationen einheitlich vor und nach dem Beginn und Ende der Bereichsbeschriftung geschrieben und beginnen mit „S“ oder „E“, um den Beginn oder das Ende der Bereichsanmerkung anzuzeigen.
Beispiel:
<!--=S Kommentarinhalt-->
<div>
...
</div>
<!--=E Kommentarinhalt-->
/*=S Kommentarinhalt*/
.Klasse{
...
}
.Klasse{
...
}
/*=E Kommentarinhalt*/
Einzeiliger Kommentar <br />Kommentarinformationen sollten in den zu kommentierenden Inhaltsbereich geschrieben werden. Beispiel:
<div>
<!--Kommentarinhalt-->
...
</div>
.Klasse{
/*Kommentarinhalt*/
...
}
Vorherige Seite 1 2 Nächste Seite Gesamten Artikel lesen

<<:  Bereitstellung eines MySQL-Hochverfügbarkeitsclusters und Implementierung eines Failovers

>>:  Detaillierte Erläuterung des Apache SkyWalking-Alarmkonfigurationshandbuchs

Artikel empfehlen

CSS zum Erzielen von Text auf dem Hintergrundbild

Wirkung: <div Klasse="imgs"> <...

Beispielcode zur Implementierung eines Musikplayers mit nativem JS

Dieser Artikel stellt hauptsächlich den Beispielc...

Attribute im Vue V-For-Loop-Objekt

Inhaltsverzeichnis 1. Werte innerhalb von Schleif...

So installieren Sie Tomcat8 im Docker

1. Installieren Sie Tomcat8 mit Docker 1. Suchen ...

CentOS 7.x Docker verwendet die Overlay2-Speichermethode

Bearbeiten Sie /etc/docker/daemon.json und fügen ...

Detaillierte Erklärung, warum MySQL nicht mit UNION zwei Abfragen verbinden kann

Überblick UNION Mit dem Schlüsselwort „Verbindung...

So bereinigen Sie Ihre Docker-Daten vollständig

Inhaltsverzeichnis Regelmäßig beschneiden Spiegel...

So installieren Sie MySQL 8.0 in Docker

Umgebung: MacOS_Cetalina_10.15.1, Mysql8.0.18, Do...

MySQL-Lösung für zeitgesteuerte Backups (mithilfe von Linux crontab)

Vorwort Obwohl manche Liebe auf dieser Welt ihren...

So implementieren Sie eine MySQL-Datenbanksicherung in Golang

Hintergrund Navicat ist das beste MySQL-Visualisi...