Извлечение документа комментирует от [закрытого] исходного файла C#
Это похоже на ошибку в ggplot2 или, по крайней мере, то, что я считаю нежелательным / неожиданным поведением. Возможно, вы видели подход , предложенный здесь , который использует заполнение строк на моноширинном шрифте для достижения выравнивания.
Это довольно забавно, но если вам нужно добиться выравнивания, используя определенный шрифт, вы можете полностью заменить метки оси на geom_text. У меня есть в основном работающее решение, но оно уродливо, потому что каждый шаг, кажется, нарушает что-то еще! 0 "на оси x фиктивной фасетки. Нужен еще один хак, чтобы избавиться от этого!)
3 ответа
Нет необходимости кататься самостоятельно, взгляните на cr-documentor .
CR_Documentor - это плагин для DXCore , позволяющий просматривать как будет выглядеть документация когда он отображается - в окне инструмента внутри Visual Studio.
Он работает довольно хорошо, но я подозреваю, что он работает вместе с Resharper, немного шатко, поэтому я отключаю его, пока не использую.
комментарии. .Cs файлы автоматически отправляются в XML-файл. Ниже приведены инструкции:
- Откройте свойства проекта -> Build
- перейдите вниз, есть раздел «Вывод»
- Включите флажок «Файл документации XML» и установите выходной путь для этого файла
- в этот файл будет скопирована вся документация вашего кода, когда вы его создадите.
Получив все комментарии из вашего проекта, вы можете использовать его любым способом.
http: // msdn. microsoft.com/en-us/magazine/cc302121.aspx
recommendation:
you вы можете отключить его во время вашей повседневной работы, как если бы размер проекта был увеличен, во время сборки будет сгенерирован этот файл так как нужно все комментарии комментировать. Просто запустите, когда вы выпускаете код, чтобы получить всю документацию.
Я только что написал инструмент, который делает это. Это всего лишь несколько строк кода, и он еще не закончен, но его очень просто расширить (я мог бы сделать это где-нибудь завтра).
Результат: просто щелкните по извлечению из меню, и результат будет в буфере обмена .
Два очень простых шага:
- Написать программу, которая принимает файл в качестве аргумента, принимает часть текста из этого файла и вставьте его в буфер обмена.
- Интегрируйте эту программу в вашу IDE.
ШАГ 1, часть 1 Основная программа, возьмите файл, отправьте его в «экстрактор» и запишите результаты в буфер обмена.
class Program
{
[STAThread]
static void Main(string[] args)
{
if (args.Length == 0) return;
FileInfo f = new FileInfo(args[0]);
Extracter e = new Extracter(f.OpenText().ReadToEnd());
Clipboard.SetText(e.GetExtractedText());
}
}
ШАГ 1, часть 2 Извлечение: извлеките из него все необходимые текстовые шаблоны, используя, конечно, регулярное выражение, и верните соответствующую строку. Я пропустил комментарии для плотности поста, и так как принцип прост и уже объяснен.
public class Extracter
{
private Regex re;
// extend/adapt regex patterns for better result.
const String RE_COMMENT_AND_NEXT_LINE= @"(?<=([\/]{3})).+";
public string FileText { get; set; }
public Extracter(String FileText)
{
this.FileText = FileText;
}
public String GetExtractedText()
{
StringBuilder sb = new StringBuilder(String.Empty);
re = new Regex(RE_COMMENT_AND_NEXT_LINE);
foreach (Match match in re.Matches(FileText))
{
sb.Append(match.ToString());
}
return sb.ToString();
}
}
ШАГ 2: Добавить в IDE
Эта IDE зависит, конечно, но всегда легко. Смотрите мой скриншот для VS2008:
