Фиксация поврежденных путей в ASDoc?

Работает ли это, если вы используете экранированные запятые с \?

Имя, возраст, пол

"Кантор \, Георг", 163, М

В большинстве форматов с разделителями требуется экранировать их по порядку правильно разобрать.


Грубый пример Java:

import java.util.Iterator;

public class CsvTest {

    public static void main(String[] args) {
        String[] lines = { "Name, Age, Sex", "\"Cantor, Georg\", 163, M" };

        StringBuilder result = new StringBuilder();

        for (String head : iterator(lines[0])) {
            result.append(String.format("<tr>%s</tr>\n", head));
        }

        for (int i=1; i < lines.length; i++) {
            for (String row : iterator(lines[i])) {
                result.append(String.format("<td>%s</td>\n", row));
            }
        }

        System.out.println(String.format("<table>\n%s</table>", result.toString()));
    }

    public static Iterable<String> iterator(final String line) {
        return new Iterable<String>() {
            public Iterator<String> iterator() {
                return new Iterator<String>() {
                    private int position = 0;

                    public boolean hasNext() {
                        return position < line.length();
                    }

                    public String next() {
                        boolean inquote = false;
                        StringBuilder buffer = new StringBuilder();
                        for (; position < line.length(); position++) {
                            char c = line.charAt(position);
                            if (c == '"') {
                                inquote = !inquote;
                            }
                            if (c == ',' && !inquote) {
                                position++;
                                break;
                            } else {
                                buffer.append(c);
                            }
                        }
                        return buffer.toString().trim();
                    }

                    public void remove() {
                        throw new UnsupportedOperationException();
                    }
                };
            }
        };
    }
}
6
задан fenomas 5 June 2009 в 05:33
поделиться

3 ответа

ASDoc бесконечно разочаровывает. Вы пробовали явно добавить полное имя пакета / класса в @see, например:

@see myPackage.myClass#MyProperty

Чтобы увидеть, имеет ли это значение?

Редактировать

Я провел несколько тестов на основе ваших результатов и внутреннего маркера свойств у меня работает. ie

@see #_dispatcher

Ссылки непосредственно на это свойство на странице (без двойной подпапки). Я думаю, может быть, вам нужно переосмыслить то, как вы выполняете команду. Например, моя кодовая база настроена следующим образом:

/src
    /com
        /bkwld
            /fetch

Я обычно запускаю asdoc внутри «src»:

asdoc -source-path . -doc-classes com/bkwld/fetch/Fetch

Я пробовал все это в Fetch.as, и все они работали, как ожидалось:

*  @see FetchItem
*  @see com.bkwld.utils.Logger
*  @see #_dispatcher

Сначала меня перевели в FetchItem страница, вторая привела меня на страницу Logger в другом пакете, а третья перешла на страницу с защищенными методами Fetch.

Просто из любопытства ... какую версию sdk вы используете?

1
ответ дан 17 December 2019 в 22:14
поделиться

Думаю, проблема в вашей строке

-doc-sources myPackage

, указывающей '.' там вместо myPackage нужно исправить (так что сделайте его идентичным исходному пути)

0
ответ дан 17 December 2019 в 22:14
поделиться

Я написал простой скрипт Python, который исправляет пути, неправильно сгенерированные asdoc в упомянутом выше случае. А именно, если есть метод myMethod (v: MyClass, ...) asdoc неправильно генерирует ссылку href = "../ mypackage: Myclass" Сценарий исправит это, заменив: на /

. Я должен заметить, что создаваемые мной документы имеют довольно «плоскую» структуру, то есть один пакет с кучей классов. Понятия не имею, работает ли исправление с более сложной структурой документации.

В любом случае, если кто-то захочет попробовать сценарий, я буду рад его отправить.

0
ответ дан 17 December 2019 в 22:14
поделиться
Другие вопросы по тегам:

Похожие вопросы: