2016-12-09 3 views
1

Wenn ich ein Stück Code oder Ressourcen fetch von etc Internet verwende, möchte ich dies in der Klassen- oder Funktionsdokumentation hervorheben und auch einen Link zur Originalquelle bereitstellen. Ich möchte jedoch auch beim Schreiben von Code für eine bessere Lesbarkeit an das Prinzip von maximal 80 Zeichen pro Zeile denken. Gibt es eine Möglichkeit, eine lange URL in der Quelle zu mehreren Zeilen zu analysieren und trotzdem die ursprüngliche Adresse als verwendbar zu erhalten, wenn das Javadoc in IDE wie Eclipse verwendet wird? Und mit benutzbar, bedeutet das Klicken auf die URL in javadoc Tooltip öffnet die richtige Seite.Eine lange URL zu mehreren Zeilen in javadoc brechen

Zum Beispiel, wie würden Sie das folgende Format:

/** 
* Class to do some cool stuff 
* Original source: 
* http://stackoverflow.com/questions/and-huge-amouts-of-URL-address-which-does-not-fit-to-80-chars 
*/ 
public class ExampleClass { 

} 
+1

Ich glaube nicht. Verwenden Sie einen Linkverkürzer, vielleicht? Auf SO, fwiw, können Sie die URL nur bis zur Frage-ID verwenden. Zum Beispiel ist diese Frage bei http://stackoverflow.com/questions/41056517. – yshavit

+0

* "Ich würde auch gerne beim Schreiben von Code für eine bessere Lesbarkeit an das Prinzip von maximal 80 Zeichen pro Zeile denken" * Es ist ein Grundsatz, kein Gesetz, das dich wegen Verletzung des Gesetzes ins Gefängnis schickt. Lange URLs sind nicht lesbar. Wenn Sie einen Link-Shortener verwenden, wird die Verknüpfung völlig unklar, d. H. Nicht lesbar. Also, was genau willst du lesbar machen? Was ist, wenn die Javadoc-Quelle eine lange Zeile mit einer URL hat, die sowieso nicht lesbar ist? Einfach das kompilierte Javadoc lesbar machen, wie [philantrovert zeigte] (http://stackoverflow.com/a/41056619/5221149). – Andreas

+0

Ich weiß, es ist kein Gesetz, aber manchmal stößt man auf eine Sache wie diese und ich bin der Typ, der irritiert und neugierig ist, einen Workaround zu finden :) Aber ich werde mich jetzt mit verkürzten Links begnügen. Danke Leute! – pnkkr

Antwort

2

Wenn Sie nicht wollen, eine URL Shortener verwenden Sie Ihre URL mit <pre></pre> Tags umschließen kann wie folgt:

/** 
* Class to do some cool stuff 
* Original source: 
* <pre> 
* See <a href="http://stackoverflow.com/questions/ 
    and-huge-amouts-of-URL-address-which-does-not-fit-to-80-chars">NameOfyourLink</a> 
* </pre> 
*/ 

Dies wird check zum Beispiel erfüllen und Sie lassen Behalten Sie Ihre ursprüngliche URL bei.

2

Stattdessen können Sie verwenden, um die folgenden

@see <a href = "https://stackoverflow.com/questions/and-huge-amouts-of-URL-address-which-does-not-fit-to-80-chars"> SO Link </a> 

und es wird so gemacht werden:

Siehe auch : SO Link

Quelle: javadoc

+1

Dies ist eine gute Möglichkeit, die Verknüpfung zu verkürzen, die der Benutzer im Tooltip sieht, aber in der ursprünglichen Quelle überschreitet die Verknüpfung immer noch das 80-Zeichen-Limit. – pnkkr

+1

Dann denke ich, die einzige Go-to-Lösung wäre ein URL-Shortener. – philantrovert

Verwandte Themen