Tracker/de: Difference between revisions
(Updating to match new version of source page) |
No edit summary |
||
(55 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{docnav|Licence|Bug Triage}} |
|||
{{Docnav/de |
|||
|[[Third_Party_Tools/de|Drittanbieterwerkzeuge]] |
|||
|[[Debugging/de|Fehlerbereinigung]] |
|||
}} |
|||
{{TOCright}} |
{{TOCright}} |
||
[[File:Mantis_logo_262x90.png|center|link=https://freecadweb.org/tracker/MantisBT is the bugtracker framework FreeCAD uses]] |
|||
{{VeryImportantMessage|Im Februar 2022 wurde das FreeCAD-Bug-Tracking nach [https://github.com/FreeCAD/FreeCAD/issues GitHub Issues] verschoben. Der unten beschriebene Mantis-Bug-Tracker ist jetzt im Read-Only-Modus.}} |
|||
The [https://www.freecadweb.org/tracker FreeCAD BugTracker] is the place toː report bugs, submit feature requests, patches, or request to merge your branch if you developed something using Git. The tracker is divided into 'Workbenches', so please be specific and file your request in the appropriate subsection. In case of doubt, leave it in the "FreeCAD" section. |
|||
[[File:Mantis_logo_262x90.png|center|link=https://freecadweb.org/tracker/MantisBT ist das von FreeCAD verwendete Fehlerverfolgungs-Rahmenwerk]] |
|||
Der [https://www.freecadweb.org/tracker FreeCAD FehlerVerfolger] ist der Ort umː Fehler zu melden, Funktionsanfragen zu übermitteln, Änderungssätze einzureichen oder deine Verzweigung zusammenführen zu können, wenn du etwas unter Verwendung von Git entwickelt hast. Der Verfolger ist in 'Arbeitsbereiche' unterteilt, also sei bitte präzise und reiche deine Anfrage in dem entsprechenden Unterabschnitt ein. Im Zweifelsfall belasse sie im Abschnitt "FreeCAD". |
|||
== Recommended Workflow == |
|||
[[File:Bugreport-workflow.png|center]] |
|||
As shown in the above flowchart, before creating tickets, please always first search the forums and bugtracker to discover if your issue is a known issue. This saves a lot of time/work for developers and volunteers that could be spending said time making FreeCAD even more awesome. |
|||
== |
== Empfohlener Arbeitsablauf == |
||
[[File:Bugreport-workflow.png|center]] |
|||
Wie im obigen Flussdiagramm dargestellt, durchsuche bitte vor dem Erstellen von Tickets immer zuerst die Foren und den Fehlerverfolger, um herauszufinden, ob dein Problem ein bekanntes Problem ist. Dies erspart Entwicklern und Freiwilligen eine Menge Zeit/Arbeit, die diese Zeit damit verbringen könnte, FreeCAD noch fantastischer zu machen. |
|||
If you think you might have found a bug, you are welcome to report it as long as you have followed our step-by-step guidelinesː |
|||
<span id="Reporting_bugs"></span> |
|||
* Make sure you're using the most up to date version of FreeCAD. '''NOTEː''' your bug may be fixed in the Development (unstable) version. The average user runs the stable version of FC. |
|||
== Fehler melden == |
|||
* Make sure your bug is really a bug, that is, something that should be working but isn't. '''Make sure the same bug hasn't been reported before by first searching the bugtracker and forum'''. |
|||
** Rememberː if you aren't sure, please don't hesitate to explain your problem/bug in the [http://forum.freecadweb.org/viewforum.php?f=3 Help forum] and ask what to do. |
|||
** '''Note'''ː before posting to the forum please read the [https://forum.freecadweb.org/viewtopic.php?f=3&t=2264 Forum Guidelines]. |
|||
* Describe as clearly as possible the problem, and how it can be reproduced. If we can not verify the bug, we might not be able to fix it. |
|||
** This means '''reporting in a clear, well-formatted, step-by-step fashion''' so even an amateur user could reproduce. |
|||
** Recommendedː '''Screenshots''' of the bug are also very helpful to include. Windows users: please do not attach screen captures in Word or PDF format. Use the Windows Snipping tool to save your capture as a PNG image. |
|||
** Recommendedː Even better, an '''Animated gif or Screencast''' would also increase the likelihood of reproducing the issue. |
|||
* '''Add an example FreeCAD file''' (.FCStd file) so devs/testers can quickly reproduce the bug. |
|||
** Please don't zip your *.FCStd file, it is already zipped. |
|||
** File attachments are limited in size. If your *.FCStd file is too big to attach, you can use an online storage service (many are free like Google Drive, Microsoft OneDrive, Dropbox). |
|||
* Include all the information from the "Copy to Clipboard" button in the '''Help (menu) -> About FreeCAD''' dialogue. Make sure your data includes your OCC or OCE version. |
|||
* Please file one separate report for each bug. |
|||
* If your bug causes a crash in FreeCAD and you're on a system that supports it you can try running a '''debug backtrace''' and attach said trace to the ticket. This can save devs a lot of time pinpointing the source of the crash. See [[Debugging|Debugging]] for more details. |
|||
Wenn du glaubst, einen Fehler gefunden zu haben, kannst du ihn gerne melden, solange du unsere Schritt-für-Schritt-Richtlinien befolgt hast. |
|||
== Requesting features == |
|||
* Stelle sicher, dass du die aktuellste Version von FreeCAD verwendest. '''ANMERKUNGː''' Dein Fehler ist möglicherweise in der (instabilen) Entwicklungsversion behoben. Der durchschnittliche Benutzer verwendet die stabile Version von FC. |
|||
If you want something to appear in FreeCAD that is not implemented yet, <u>it is not a bug but a feature request</u>. |
|||
* Stelle sicher, dass dein Fehler wirklich ein Fehler ist, d.h. etwas, das funktionieren sollte, es aber nicht tut. '''Stelle sicher, dass derselbe Fehler nicht schon einmal gemeldet wurde, indem du zuerst den Fehlerverfolger und das Forum durchsuchst'''. |
|||
** Bedenkeː Wenn du dir nicht sicher ist, zögere bitte nicht, dein Problem/Fehler im [http://forum.freecadweb.org/viewforum.php?f=3 Hilfeforum] zu erklären und zu fragen, was zu tun ist. |
|||
** '''Hinweis''''ː Bevor ein Beitrag fürs Forum verfasst wird, lies bitte die [https://forum.freecadweb.org/viewtopic.php?f=3&t=2264 Forumsrichtlinien]. |
|||
* Beschreibe so klar wie möglich das Problem und wie es reproduziert werden kann. Wenn wir den Fehler nicht verifizieren können, sind wir möglicherweise nicht in der Lage, ihn zu beheben. |
|||
** Das bedeutet '''Berichterstattung in einer klaren, gut formatierten, Schritt-für-Schritt Art und Weise'', so dass selbst ein Amateuranwender den Fehler reproduzieren kann. |
|||
** Empfohlenː '''Bildschirmfotos''' des Fehlers sind ebenfalls sehr hilfreich einzufügen. Windowsanwender: Bitte füge keine Bildschirmfotos im Word oder PDF Format bei. Verwende das Windows Snipping Werkzeug, um dein Aufnahme als PNG Bild zu speichern. |
|||
** Empfohlenː Noch besser, ein '''Animiertes Gif oder Screencast''' würde auch die Wahrscheinlichkeit erhöhen, das Problem zu reproduzieren. |
|||
* '''Füge eine Beispiel FreeCAD Datei hinzu''' (.FCStd Datei), damit Entwickler/Tester den Fehler schnell reproduzieren können. |
|||
** Bitte packe deine *.FCStd-Datei nicht, sie ist bereits gepackt. |
|||
** Dateianhänge sind in der Größe begrenzt. Wenn deine *.FCStd Datei zu groß ist, um sie anzuhängen, kannst du einen Online Speicherdienst nutzen (viele sind kostenlos wie Google Drive, Microsoft OneDrive, Dropbox). |
|||
* Füge alle Informationen aus der Schaltfläche "In die Zwischenablage kopieren" in den Dialog '''Hilfe (Menü) -> Über FreeCAD'''' ein. Stelle sicher, dass deine Daten deine OCC oder OCE Version enthält. |
|||
* Bitte reiche für jeden Fehler einen separaten Bericht ein. |
|||
* Wenn dein Fehler einen Absturz in FreeCAD verursacht und du dich auf einem System befindest, das dies unterstützt, kannst du versuchen, einen '''debug backtrace''' auszuführen und diesen Trace an das Ticket anzuhängen. Dies kann Entwicklern viel Zeit ersparen, die Quelle des Absturzes zu lokalisieren. Siehe [[Debugging/de|Fehlerdiagnose]] für weitere Einzelheiten. |
|||
<span id="Requesting_features"></span> |
|||
# '''IMPORTANTː''' Before requesting a potential Feature Request '''please be certain that you are the first one doing so by searching the forums and the bugtracker'''. If you have concluded that there are no pre-existing tickets/discussions the next step is toː |
|||
== Anfordern von Funktionen == |
|||
# Start a forum thread to discuss your feature request with the community via the [http://forum.freecadweb.org/viewforum.php?f=8 Open Discussion forum]. |
|||
# Once the community agrees that this is a valid Feature, you then can open a ticket on the tracker (file it under ''feature request'' instead of ''bug''). |
|||
* '''NOTE #1''' To keep things organized please remember to link the forum thread URL into the ticket and the ticket number (as a link) in to the forum thread. |
|||
* '''NOTE #2''' Keep in mind there are no guarantees that your wish will be fulfilled. |
|||
[[File:MantisBT-setting-Feature-Request.jpg|thumb|FreeCAD Bugtracker report page - use the dropdown to correctly designate what the ticket is]] |
|||
Wenn du möchtest, dass etwas in FreeCAD erscheint, das noch nicht implementiert ist, <u>es handelt sich nicht um einen Fehler, sondern um eine Funktionsanfrage</u>. |
|||
== Submitting patches == |
|||
# '''WICHTIGː''' Bevor ein potentielle Funktionsanfrage gestellt wird, '''stelle bitte sicher, dass du der erstebist, der dies tut, indem du die Foren und den Fehlerverfolger durchsuchst'''. Wenn du zu dem Schluss gekommen bist, dass es keine bereits existierenden Tickets / Diskussionen gibt, ist der nächste Schrittː |
|||
In case you have programmed a bug fix, an extension or something else that can be of public use in FreeCAD, create a patch using the Git diff tool and submit it on the same tracker (file it as ''patch''). |
|||
# Starte einen Forumsbeitrag, um deinen Funktionsanfrage mit der Gemeinschaft über das [http://forum.freecadweb.org/viewforum.php?f=8 Diskussionsforum öffnen] zu diskutieren. |
|||
# Sobald die Gemeinschaft damit einverstanden ist, dass es sich um ein gültige Funktion handelt, kannst du ein Ticket auf dem Fehlerverfolger öffnen (legen es unter ''Funktionsanfrage'' statt ''Fehler'' ab). |
|||
* '''ANMERKUNG #1''' Um die Dinge in Ordnung zu halten, denke bitte daran, die URL des Forumsbeitrag in das Ticket und die Ticketnummer (als Verknüpfung) in den Forumbeitrag zu verknüpfen. |
|||
* '''ANMERKUNG #2''' Beachte bitte, dass es keine Garantien gibt, dass dein Wunsch erfüllt wird. |
|||
[[File:MantisBT-setting-Feature-Request.jpg|thumb|FreeCAD Fehlerverfolger-Berichtsseite - verwende die Auswahlliste, um korrekt zu bestimmen, was das Ticket ist]] |
|||
<span id="Submitting_patches"></span> |
|||
Addendumː FreeCAD development has switched to the [https://github.com/FreeCAD/FreeCAD GitHub] development model so the workflow for submitting patches has been greatly enhanced/streamlined by submitting Pull Requests. |
|||
== Einreichen von Änderungssätzen == |
|||
* Open a forum thread in the Developer subforum to announce and discuss your patch. |
|||
* Submit your PR to the [http://github.com/FreeCAD/FreeCAD FreeCAD GitHub repo]. Be sure to link the forum thread in to the git commit summary. |
|||
* Paste the PR link in to the forum thread for the devs/testers to test. |
|||
* Be present for the discussion so that your code can potentially be merged more effectively. |
|||
'''NOTEː''' the FreeCAD community recommends to first discuss any large revision to the source code in advance to save everyone time. |
|||
Falls du eine Fehlerbehebung, eine Erweiterung oder etwas anderes programmiert hast, das in FreeCAD von öffentlichem Nutzen sein kann, sende deinen Änderungssatz als "Pull Request" an [https://github.com/FreeCAD/FreeCAD GitHub]. |
|||
== Requesting merge == |
|||
# Für große, komplexe oder ablaufändernde Einsendungen öffnet man einen ForumThread im [https://forum.freecadweb.org/viewforum.php?f=10 Developer subforum], um den Änderungssatz anzukündigen und zu diskutieren. Für kleine Fehlerbehebungen ist dies nicht nötig. |
|||
# Der Pull Request (PR) wird an das [http://github.com/FreeCAD/FreeCAD FreeCAD GitHub repo] gesendet. Die PR-Sendungsbenachrichtigung wird vorausgefüllt mit einer Checkliste, der man folgen kann, um sicherzugehen, dass die Einsendung die besten Chancen hat, schnell akzeptiert zu werden. Wer noch nicht mit {{incode|git}} gearbeitet hat oder sich mit dem Senden eines PR nach github nicht sicher auskennt, sollte unsere Wiki-Seite zur Einführung in [[Source_code_management|github]] lesen. |
|||
# Man sollte für Diskussionen erreichbar sein, sowohl im Forum als auch für den GitHub-Pull-Request, damit der Kode möglichst effektiv eingefügt werden kann. |
|||
<span id="Requesting_merge"></span> |
|||
(Same guidelines as [https://www.freecadweb.org/wiki/Tracker#Submitting_patches Submiting patches]) |
|||
== Zusammenführen anfragen == |
|||
(Dieselben Richtlinien wie [https://www.freecadweb.org/wiki/Tracker#Submitting_patches Einreichen von Änderungssätzen]) |
|||
If you have created a git branch containing changes that you would like to see merged into the FreeCAD code, you can ask there to have your branch reviewed and merged if the FreeCAD developers are OK with it. You must first publish your branch to a public git repository (github, gitlab, bitbucket, sourceforge etc...) and then give the URL of your branch in your merge request. |
|||
Wenn du einen Git Zweig erstellt hast, der Änderungen enthält, die du gerne im FreeCAD Code zusammengeführt sehen möchtest, kannst du dort darum bitten, dass dein Zweig überprüft und zusammengeführt wird, wenn die FreeCAD Entwickler damit einverstanden sind. Du musst zuerst deinen Zweig in einem öffentlichen Git Repositorium (github, gitlab, bitbucket, sourceforge etc...) veröffentlichen und dann die URL deines Zweiges in deiner Zusammenführungsanfrage angeben. |
|||
== MantisBT Tips and Tricks == |
|||
<span id="MantisBT_Tips_and_Tricks"></span> |
|||
=== MantisBT Markup === |
|||
== MantisBT Tips und Tricks == |
|||
MantisBT (Mantis Bug Tracker) has it's own unique markup. |
|||
* '''@'''mention - works just like on GitHub where if you prepend '@' to someone's username they will receive an email that they have been 'mentioned' in a ticket thread |
|||
=== MantisBT Kennzeichnungen === |
|||
MantisBT (Mantis Bug Tracker) hat seine eigene einzigartige Kennzeichnung. |
|||
* '''@'''mention - funktioniert genau wie bei GitHub, wo, wenn du dem Benutzernamen von jemandem ein '@' voranstellen, dieser eine E-Mail erhält, dass er in einem Ticket Beitrag 'erwähnt' wurde. |
|||
[[File:mantisbt-mention-example.jpg|center|600px]] |
[[File:mantisbt-mention-example.jpg|center|600px]] |
||
* '''#'''1234 - |
* '''#'''1234 - Durch Hinzufügen eines Hashtags vor einer Nummer wird eine Verknüpfung zu einem anderen Ticket innerhalb von MantisBT angezeigt. |
||
*: ''' |
*: '''Hinweis'''': wenn du der Maus über ein Ticket fährst, wird dir die Zusammenfassung angezeigt + wenn das Ticket geschlossen ist, wird es durchgestrichen wie <s>#1234</s>. |
||
[[File:mantisbt-ticket-shortcut-example.jpg|center|600px]] |
[[File:mantisbt-ticket-shortcut-example.jpg|center|600px]] |
||
* '''~'''5678 - a shortcut that links to a bug note within a ticket. This can be used to reference someone's response within the thread. Each person that posts will show a unique ~#### number next to their username. If you look at the image in the example, you see that the shortcut is referencing the ''ticket number:comment number'' of said ticket |
|||
* '''~'''5678 - eine Abkürzung, die auf einen Fehlerhinweis innerhalb eines Tickets verweist. Dies kann verwendet werden, um auf die Antwort von jemandem innerhalb des Beitrags zu verweisen. Jede Person, die einen Beitrag verfasst, zeigt eine eindeutige Nummer ~#### neben ihrem Benutzernamen. Wenn du dir das Bild im Beispiel ansiehst, siehst du, dass die Abkürzung auf die ''Ticketnummer:Kommentarnummer'' des besagten Tickets verweist |
|||
[[File:mantisbt-comment-shortcut-example.jpg|center|600px]] |
[[File:mantisbt-comment-shortcut-example.jpg|center|600px]] |
||
* '''<nowiki><del></del></nowiki>''' - |
* '''<nowiki><del></del></nowiki>''' - Die Verwendung dieser Tags wird <s>Text durchstreichen</s>. |
||
[[File:mantisbt-strikeout-text-example.jpg|center|600px]] |
[[File:mantisbt-strikeout-text-example.jpg|center|600px]] |
||
* '''<nowiki><code></code></nowiki>''' - |
* '''<nowiki><code></code></nowiki>''' - Um eine Zeile oder einen Code Block zu präsentieren, verwende diesen Tag, und er wird ihn elegant einfärben und differenzieren. |
||
[[File:mantisbt-colorized-code-example.jpg|center|600px]] |
[[File:mantisbt-colorized-code-example.jpg|center|600px]] |
||
=== MantisBT BBCode |
=== MantisBT BBCode === |
||
Zusätzlich zu dem obigen [[Tracker/de#MantisBT_Markup|MantisBT Kennzeichnung]] hat man auch die Möglichkeit, das BBCode Format zu verwenden. Für eine umfassende Liste siehe die [https://github.com/mantisbt-plugins/BBCodePlus#supported-bbcode-tags BBCode plus Plugin Seite]. Hier ist eine Liste der unterstützten BBCode tagsː |
|||
<small><code><br /> |
<small><code><br /> |
||
[img][/img] - |
[img][/img] - Bilder <br /> |
||
[url][/url] - |
[url][/url] - Verweise <br /> |
||
[email][/email] - |
[email][/email] - E-Mail Adressen <br /> |
||
[color=red][/color] - |
[color=red][/color] - Farbiger Text <br /> |
||
[highlight=yellow][/highlight] - |
[highlight=yellow][/highlight] - Hervorgehobener Text <br /> |
||
[size][/size] - |
[size][/size] - Schriftgröße <br /> |
||
[list][/list] - |
[list][/list] - Listen <br /> |
||
[list=1][/list] - |
[list=1][/list] - Nummerierte Listen (Zahl ist die Startnummer) <br /> |
||
[*] - |
[*] - Punkte auflisten <br /> |
||
[b][/b] - |
[b][/b] - Fett <br /> |
||
[u][/u] - |
[u][/u] - Unterstreichen <br /> |
||
[i][/i] - |
[i][/i] - Kursiv <br /> |
||
[s][/s] - |
[s][/s] - Durchgestrichen <br /> |
||
[left][/left] - |
[left][/left] - Linksbündig <br /> |
||
[center][/center] - |
[center][/center] - Zentriert <br /> |
||
[right][/right] - |
[right][/right] - Rechtsbündig <br /> |
||
[justify][/justify] - |
[justify][/justify] - Blockanordnung <br /> |
||
[hr] - |
[hr] - Horizontale Regel <br /> |
||
[sub][/sub] - |
[sub][/sub] - tiefgestellt <br /> |
||
[sup][/sup] - |
[sup][/sup] - Hochgestellt <br /> |
||
[ |
[Tabelle][/Tabelle] - Tabelle <br /> |
||
[table=1][/table] - |
[table=1][/table] - Tabelle mit Rahmen der angegebenen Breite <br /> |
||
[tr][/tr] - |
[tr][/tr] - Tabellenzeile <br /> |
||
[td][/td] - |
[td][/td] - Tabellenspalte <br /> |
||
[code][/code] - Code |
[code][/code] - Code Block <br /> |
||
[code=sql][/code] - |
[code=sql][/code] - Codeblock mit Sprachdefinition <br /> |
||
[code start=3][/code] - |
[code start=3][/code] - Codeblock mit Zeilennummern, die mit der Zahl beginnen <br /> |
||
[quote][/quote] - |
[quote][/quote] - Zitat von *einem* (kein Name) <br /> |
||
[quote=name][/quote] - |
[quote=name][/quote] - Zitat nach *Name* <br /> |
||
</code> |
</code> |
||
</small> |
</small> |
||
=== MantisBT <=> GitHub Markup === |
|||
=== MantisBT <=> GitHub Kennzeichnung === |
|||
Below are special MantisBT Source-Integration plugin keywords which will link to the FreeCAD GitHub repo. See [[Tracker#GitHub_and_MantisBT]]. |
|||
Unten sind spezielle MantisBT Quellcode Integrations Zusatzmodul Schlüsselwörter, die mit dem FreeCAD GitHub Repo verknüpfen. Siehe [[Tracker#GitHub_and_MantisBT|GitHubd und MantisBT]]. |
|||
* '''c:FreeCAD:git commit hash:''' - '''c''' stands for 'commit'. FreeCAD stands for the FreeCAD GitHub repo. 'git commit hash' is the specific git commit hash to reference. Note: the trailing colon is necessary. Exampleː <code>cːFreeCADː709d2f325db0490016807b8fa6f49d1c867b6bd8ː</code> |
|||
* ''' |
* '''c:FreeCAD:git commit hash:''' - '''c''' steht für 'commit'. FreeCAD steht für das FreeCAD GitHub Repo. 'git commit hash' ist der spezifische Git Commit Hash, auf den verwiesen wird. Hinweis: Der abschließende Doppelpunkt ist notwendig. Beispielː <code>cːFreeCADː709d2f325db0490016807b8fa6f49d1c867b6bd8ː</code> |
||
* ''' |
* '''d:FreeCAD:git commit hash:''' - Ähnlich zum oberen "d" steht für "diff", was eine Diff Ansicht der commit liefert. Beispielː <code>dːFreeCADː709d2f325db0490016807b8fa6f49d1c867b6bd8ː</code> |
||
* '''p:FreeCAD:pullrequest:''' - Ähnlich zum oberen, '''p''' steht für Pull Request. Beispielː <code>pːFreeCADː498ː</code> |
|||
[[File:mantisbt-source-integration-markup.jpg|center|600px]] |
[[File:mantisbt-source-integration-markup.jpg|center|600px]] |
||
{{clear}} |
{{clear}} |
||
== GitHub |
== GitHub und MantisBT == |
||
Der FreeCAD Fehlerverfolger verfügt über ein ZUsatzprogramm namens [https://github.com/mantisbt-plugins/source-integration Quellintegration], das im Wesentlichen sowohl das FreeCAD GitHub Repo als auch unseren MantisBT Fehlerverolger verbindet. Es macht es einfacher, Git Verpflichtungen zu verfolgen und mit ihren jeweiligen MantisBT Tickets zu verknüpfen. '''Das Quellintegrationszusatzprogramm durchsucht die Git Verpflichtungsnachrichten nach bestimmten Schlüsselwörtern, um die folgenden Aktionen auszuführen:''' |
|||
''' |
'''Hinweis''' Die folgenden Schlüsselwörter müssen in der <u>git commit message</u> und nicht im PR Thema hinzugefügt werden |
||
=== |
=== Fernreferenzierung eines Tickets === |
||
Durch die Verwendung dieses Musters wird ein Git Commit automatisch einem Ticket zugeordnet ('''Hinweis:'''' dies wird das Ticket nicht schließen). |
|||
Using this pattern will automagically associate a git commit to a ticket ('''Note:''' this will not close the ticket.) |
|||
Das Format wird von MantisBT erkannt: |
|||
The format MantisBT will recognize: |
The format MantisBT will recognize: |
||
* bug #1234 |
* bug #1234 |
||
Line 131: | Line 143: | ||
* report #1234 |
* report #1234 |
||
* reports #1234, #5678 |
* reports #1234, #5678 |
||
<small> |
<small>Für die Neugierigen hier ist die regex, die MantisBT für diese Operation verwendet: |
||
<br /> |
|||
<code>/(?:bugs?|issues?|reports?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i</code></small> |
<code>/(?:bugs?|issues?|reports?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i</code></small> |
||
=== |
=== Ferngesteuerte Lösung eines Tickets === |
||
Das Format wird von MantisBT erkannt:* fix #1234 |
|||
The format MantisBT will recognize: |
|||
* fix #1234 |
|||
* fixed #1234 |
* fixed #1234 |
||
* fixes #1234 |
* fixes #1234 |
||
Line 146: | Line 158: | ||
* resolved #1234, #5678 |
* resolved #1234, #5678 |
||
* resolves #1234, #5678 |
* resolves #1234, #5678 |
||
<small> |
<small>Für die Neugierigen hier ist die regex, die MantisBT für diese Operation verwendet: |
||
<br /> |
|||
<code>/(?:fixe?d?s?|resolved?s?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i</code></small> |
<code>/(?:fixe?d?s?|resolved?s?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i</code></small> |
||
== Related == |
|||
* [[Bug Triage]] |
|||
* [[Source Code Management]] |
|||
{{Docnav/de |
|||
{{docnav/de|Licence/de|CompileOnWindows/de}} |
|||
|[[Third_Party_Tools/de|Drittanbieterwerkzeuge]] |
|||
|[[Debugging/de|Fehlerbereinigung]] |
|||
}} |
|||
{{Userdocnavi}} |
{{Userdocnavi{{#translation:}}}} |
||
[[Category:Developer Documentation{{#translation:}}]] |
|||
[[Category:Administration{{#translation:}}]] |
|||
<div class="mw-translate-fuzzy"> |
|||
[[Category:Developer Documentation/de]] |
|||
</div> |
|||
[[Category:Administration]] |
|||
{{clear}} |
Latest revision as of 22:56, 13 December 2023
Der FreeCAD FehlerVerfolger ist der Ort umː Fehler zu melden, Funktionsanfragen zu übermitteln, Änderungssätze einzureichen oder deine Verzweigung zusammenführen zu können, wenn du etwas unter Verwendung von Git entwickelt hast. Der Verfolger ist in 'Arbeitsbereiche' unterteilt, also sei bitte präzise und reiche deine Anfrage in dem entsprechenden Unterabschnitt ein. Im Zweifelsfall belasse sie im Abschnitt "FreeCAD".
Empfohlener Arbeitsablauf
Wie im obigen Flussdiagramm dargestellt, durchsuche bitte vor dem Erstellen von Tickets immer zuerst die Foren und den Fehlerverfolger, um herauszufinden, ob dein Problem ein bekanntes Problem ist. Dies erspart Entwicklern und Freiwilligen eine Menge Zeit/Arbeit, die diese Zeit damit verbringen könnte, FreeCAD noch fantastischer zu machen.
Fehler melden
Wenn du glaubst, einen Fehler gefunden zu haben, kannst du ihn gerne melden, solange du unsere Schritt-für-Schritt-Richtlinien befolgt hast.
- Stelle sicher, dass du die aktuellste Version von FreeCAD verwendest. ANMERKUNGː Dein Fehler ist möglicherweise in der (instabilen) Entwicklungsversion behoben. Der durchschnittliche Benutzer verwendet die stabile Version von FC.
- Stelle sicher, dass dein Fehler wirklich ein Fehler ist, d.h. etwas, das funktionieren sollte, es aber nicht tut. Stelle sicher, dass derselbe Fehler nicht schon einmal gemeldet wurde, indem du zuerst den Fehlerverfolger und das Forum durchsuchst.
- Bedenkeː Wenn du dir nicht sicher ist, zögere bitte nicht, dein Problem/Fehler im Hilfeforum zu erklären und zu fragen, was zu tun ist.
- Hinweis'ː Bevor ein Beitrag fürs Forum verfasst wird, lies bitte die Forumsrichtlinien.
- Beschreibe so klar wie möglich das Problem und wie es reproduziert werden kann. Wenn wir den Fehler nicht verifizieren können, sind wir möglicherweise nicht in der Lage, ihn zu beheben.
- Das bedeutet 'Berichterstattung in einer klaren, gut formatierten, Schritt-für-Schritt Art und Weise, so dass selbst ein Amateuranwender den Fehler reproduzieren kann.
- Empfohlenː Bildschirmfotos des Fehlers sind ebenfalls sehr hilfreich einzufügen. Windowsanwender: Bitte füge keine Bildschirmfotos im Word oder PDF Format bei. Verwende das Windows Snipping Werkzeug, um dein Aufnahme als PNG Bild zu speichern.
- Empfohlenː Noch besser, ein Animiertes Gif oder Screencast würde auch die Wahrscheinlichkeit erhöhen, das Problem zu reproduzieren.
- Füge eine Beispiel FreeCAD Datei hinzu (.FCStd Datei), damit Entwickler/Tester den Fehler schnell reproduzieren können.
- Bitte packe deine *.FCStd-Datei nicht, sie ist bereits gepackt.
- Dateianhänge sind in der Größe begrenzt. Wenn deine *.FCStd Datei zu groß ist, um sie anzuhängen, kannst du einen Online Speicherdienst nutzen (viele sind kostenlos wie Google Drive, Microsoft OneDrive, Dropbox).
- Füge alle Informationen aus der Schaltfläche "In die Zwischenablage kopieren" in den Dialog Hilfe (Menü) -> Über FreeCAD' ein. Stelle sicher, dass deine Daten deine OCC oder OCE Version enthält.
- Bitte reiche für jeden Fehler einen separaten Bericht ein.
- Wenn dein Fehler einen Absturz in FreeCAD verursacht und du dich auf einem System befindest, das dies unterstützt, kannst du versuchen, einen debug backtrace auszuführen und diesen Trace an das Ticket anzuhängen. Dies kann Entwicklern viel Zeit ersparen, die Quelle des Absturzes zu lokalisieren. Siehe Fehlerdiagnose für weitere Einzelheiten.
Anfordern von Funktionen
Wenn du möchtest, dass etwas in FreeCAD erscheint, das noch nicht implementiert ist, es handelt sich nicht um einen Fehler, sondern um eine Funktionsanfrage.
- WICHTIGː Bevor ein potentielle Funktionsanfrage gestellt wird, stelle bitte sicher, dass du der erstebist, der dies tut, indem du die Foren und den Fehlerverfolger durchsuchst. Wenn du zu dem Schluss gekommen bist, dass es keine bereits existierenden Tickets / Diskussionen gibt, ist der nächste Schrittː
- Starte einen Forumsbeitrag, um deinen Funktionsanfrage mit der Gemeinschaft über das Diskussionsforum öffnen zu diskutieren.
- Sobald die Gemeinschaft damit einverstanden ist, dass es sich um ein gültige Funktion handelt, kannst du ein Ticket auf dem Fehlerverfolger öffnen (legen es unter Funktionsanfrage statt Fehler ab).
- ANMERKUNG #1 Um die Dinge in Ordnung zu halten, denke bitte daran, die URL des Forumsbeitrag in das Ticket und die Ticketnummer (als Verknüpfung) in den Forumbeitrag zu verknüpfen.
- ANMERKUNG #2 Beachte bitte, dass es keine Garantien gibt, dass dein Wunsch erfüllt wird.
Einreichen von Änderungssätzen
Falls du eine Fehlerbehebung, eine Erweiterung oder etwas anderes programmiert hast, das in FreeCAD von öffentlichem Nutzen sein kann, sende deinen Änderungssatz als "Pull Request" an GitHub.
- Für große, komplexe oder ablaufändernde Einsendungen öffnet man einen ForumThread im Developer subforum, um den Änderungssatz anzukündigen und zu diskutieren. Für kleine Fehlerbehebungen ist dies nicht nötig.
- Der Pull Request (PR) wird an das FreeCAD GitHub repo gesendet. Die PR-Sendungsbenachrichtigung wird vorausgefüllt mit einer Checkliste, der man folgen kann, um sicherzugehen, dass die Einsendung die besten Chancen hat, schnell akzeptiert zu werden. Wer noch nicht mit
git
gearbeitet hat oder sich mit dem Senden eines PR nach github nicht sicher auskennt, sollte unsere Wiki-Seite zur Einführung in github lesen. - Man sollte für Diskussionen erreichbar sein, sowohl im Forum als auch für den GitHub-Pull-Request, damit der Kode möglichst effektiv eingefügt werden kann.
Zusammenführen anfragen
(Dieselben Richtlinien wie Einreichen von Änderungssätzen)
Wenn du einen Git Zweig erstellt hast, der Änderungen enthält, die du gerne im FreeCAD Code zusammengeführt sehen möchtest, kannst du dort darum bitten, dass dein Zweig überprüft und zusammengeführt wird, wenn die FreeCAD Entwickler damit einverstanden sind. Du musst zuerst deinen Zweig in einem öffentlichen Git Repositorium (github, gitlab, bitbucket, sourceforge etc...) veröffentlichen und dann die URL deines Zweiges in deiner Zusammenführungsanfrage angeben.
MantisBT Tips und Tricks
MantisBT Kennzeichnungen
MantisBT (Mantis Bug Tracker) hat seine eigene einzigartige Kennzeichnung.
- @mention - funktioniert genau wie bei GitHub, wo, wenn du dem Benutzernamen von jemandem ein '@' voranstellen, dieser eine E-Mail erhält, dass er in einem Ticket Beitrag 'erwähnt' wurde.
- #1234 - Durch Hinzufügen eines Hashtags vor einer Nummer wird eine Verknüpfung zu einem anderen Ticket innerhalb von MantisBT angezeigt.
- Hinweis': wenn du der Maus über ein Ticket fährst, wird dir die Zusammenfassung angezeigt + wenn das Ticket geschlossen ist, wird es durchgestrichen wie
#1234.
- Hinweis': wenn du der Maus über ein Ticket fährst, wird dir die Zusammenfassung angezeigt + wenn das Ticket geschlossen ist, wird es durchgestrichen wie
- ~5678 - eine Abkürzung, die auf einen Fehlerhinweis innerhalb eines Tickets verweist. Dies kann verwendet werden, um auf die Antwort von jemandem innerhalb des Beitrags zu verweisen. Jede Person, die einen Beitrag verfasst, zeigt eine eindeutige Nummer ~#### neben ihrem Benutzernamen. Wenn du dir das Bild im Beispiel ansiehst, siehst du, dass die Abkürzung auf die Ticketnummer:Kommentarnummer des besagten Tickets verweist
- <del></del> - Die Verwendung dieser Tags wird
Text durchstreichen.
- <code></code> - Um eine Zeile oder einen Code Block zu präsentieren, verwende diesen Tag, und er wird ihn elegant einfärben und differenzieren.
MantisBT BBCode
Zusätzlich zu dem obigen MantisBT Kennzeichnung hat man auch die Möglichkeit, das BBCode Format zu verwenden. Für eine umfassende Liste siehe die BBCode plus Plugin Seite. Hier ist eine Liste der unterstützten BBCode tagsː
[img][/img] - Bilder
[url][/url] - Verweise
[email][/email] - E-Mail Adressen
[color=red][/color] - Farbiger Text
[highlight=yellow][/highlight] - Hervorgehobener Text
[size][/size] - Schriftgröße
[list][/list] - Listen
[list=1][/list] - Nummerierte Listen (Zahl ist die Startnummer)
[*] - Punkte auflisten
[b][/b] - Fett
[u][/u] - Unterstreichen
[i][/i] - Kursiv
[s][/s] - Durchgestrichen
[left][/left] - Linksbündig
[center][/center] - Zentriert
[right][/right] - Rechtsbündig
[justify][/justify] - Blockanordnung
[hr] - Horizontale Regel
[sub][/sub] - tiefgestellt
[sup][/sup] - Hochgestellt
[Tabelle][/Tabelle] - Tabelle
[table=1][/table] - Tabelle mit Rahmen der angegebenen Breite
[tr][/tr] - Tabellenzeile
[td][/td] - Tabellenspalte
[code][/code] - Code Block
[code=sql][/code] - Codeblock mit Sprachdefinition
[code start=3][/code] - Codeblock mit Zeilennummern, die mit der Zahl beginnen
[quote][/quote] - Zitat von *einem* (kein Name)
[quote=name][/quote] - Zitat nach *Name*
MantisBT <=> GitHub Kennzeichnung
Unten sind spezielle MantisBT Quellcode Integrations Zusatzmodul Schlüsselwörter, die mit dem FreeCAD GitHub Repo verknüpfen. Siehe GitHubd und MantisBT.
- c:FreeCAD:git commit hash: - c steht für 'commit'. FreeCAD steht für das FreeCAD GitHub Repo. 'git commit hash' ist der spezifische Git Commit Hash, auf den verwiesen wird. Hinweis: Der abschließende Doppelpunkt ist notwendig. Beispielː
cːFreeCADː709d2f325db0490016807b8fa6f49d1c867b6bd8ː
- d:FreeCAD:git commit hash: - Ähnlich zum oberen "d" steht für "diff", was eine Diff Ansicht der commit liefert. Beispielː
dːFreeCADː709d2f325db0490016807b8fa6f49d1c867b6bd8ː
- p:FreeCAD:pullrequest: - Ähnlich zum oberen, p steht für Pull Request. Beispielː
pːFreeCADː498ː
GitHub und MantisBT
Der FreeCAD Fehlerverfolger verfügt über ein ZUsatzprogramm namens Quellintegration, das im Wesentlichen sowohl das FreeCAD GitHub Repo als auch unseren MantisBT Fehlerverolger verbindet. Es macht es einfacher, Git Verpflichtungen zu verfolgen und mit ihren jeweiligen MantisBT Tickets zu verknüpfen. Das Quellintegrationszusatzprogramm durchsucht die Git Verpflichtungsnachrichten nach bestimmten Schlüsselwörtern, um die folgenden Aktionen auszuführen:
Hinweis Die folgenden Schlüsselwörter müssen in der git commit message und nicht im PR Thema hinzugefügt werden
Fernreferenzierung eines Tickets
Durch die Verwendung dieses Musters wird ein Git Commit automatisch einem Ticket zugeordnet (Hinweis:' dies wird das Ticket nicht schließen). Das Format wird von MantisBT erkannt: The format MantisBT will recognize:
- bug #1234
- bugs #1234, #5678
- issue #1234
- issues #1234, #5678
- report #1234
- reports #1234, #5678
Für die Neugierigen hier ist die regex, die MantisBT für diese Operation verwendet:
/(?:bugs?|issues?|reports?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i
Ferngesteuerte Lösung eines Tickets
Das Format wird von MantisBT erkannt:* fix #1234
- fixed #1234
- fixes #1234
- fixed #1234, #5678
- fixes #1234, #5678
- resolve #1234
- resolved #1234
- resolves #1234
- resolved #1234, #5678
- resolves #1234, #5678
Für die Neugierigen hier ist die regex, die MantisBT für diese Operation verwendet:
/(?:fixe?d?s?|resolved?s?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i
- Erste Schritte
- Installation: Herunterladen, Windows, Linux, Mac, Zusätzlicher Komponenten, Docker, AppImage, Ubuntu Snap
- Grundlagen: Über FreeCAD, Graphische Oberfläche, Mausbedienung, Auswahlmethoden, Objektname, Programmeinstellungen, Arbeitsbereiche, Dokumentstruktur, Objekteigenschaften, Hilf FreeCAD, Spende
- Hilfe: Tutorien, Video Tutorien
- Arbeitsbereiche: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web