Skip to content

Commit

Permalink
Modify New directory
Browse files Browse the repository at this point in the history
  • Loading branch information
ogura-i committed Mar 15, 2018
1 parent 966d845 commit 0c09941
Show file tree
Hide file tree
Showing 2 changed files with 212 additions and 168 deletions.
327 changes: 193 additions & 134 deletions 2018/New/README.org
Original file line number Diff line number Diff line change
@@ -1,134 +1,193 @@
#+TITLE: 資料の執筆の仕方
#+AUTHOR:
#+EMAIL:
#+DATE:
#+OPTIONS: H:3 num:2 toc:nil
#+OPTIONS: ^:nil @:t \n:nil ::t |:t f:t TeX:t
#+OPTIONS: skip:nil
#+OPTIONS: author:t
#+OPTIONS: email:nil
#+OPTIONS: creator:nil
#+OPTIONS: timestamp:nil
#+OPTIONS: timestamps:nil
#+OPTIONS: d:nil
#+OPTIONS: tags:t
#+TEXT:
#+DESCRIPTION:
#+KEYWORDS:
#+LANGUAGE: ja
#+STARTUP: odd
#+LATEX_CLASS: jsarticle
#+LATEX_CLASS_OPTIONS: [a4j]
#+LATEX_HEADER: \usepackage{plain-article}
# #+LATEX_HEADER: \renewcommand\maketitle{}
# #+LATEX_HEADER: \pagestyle{empty}
# #+LaTeX: \thispagestyle{empty}

* 概要
本文書は,乃村研の学生が資料を執筆する際の準備について記述している.
本文書では,LaTeX を使って資料を記述することを前提としている.

* リポジトリの準備
** テンプレートのコピー
以下では, =~/Projects= 下に =BootCamp= リポジトリを配置している.

#+BEGIN_SRC shell-script
$ git clone git@github.com:nomlab/BootCamp.git ~/Projects/
#+END_SRC

** TeX ファイルの名前変更
テンプレート中の =myproject.tex= を扱いやすいファイル名に変更する.
例えば,仕様書であれば, =specification.tex= とする.

#+BEGIN_SRC shell-script
$ cd ~/Projects/BootCamp
$ mv myproject.tex specification.tex
#+END_SRC

また,TeX ファイルの名前に合わせて make のターゲットを変更する.
プロジェクト固有の設定は, =project.mk= ファイルに記述しておくと,
Makefile から include される.
=mybibdata.bib= は,参考文献用DBファイルである.
=figs/fig.pdf= は,図をまとめたpdfファイルである.

#+BEGIN_SRC makefile
#####################################################################
# Files in the project
#####################################################################

# if the main TeX file is ``myproject.tex'', set:
# PROJECT = myproject
PROJECT = specification
PROJECT_BIB = mybibdata.bib

# All figure files are extracted from the single PDF file: FIG_MASTER_FILE.
# FIG_PAGES indicates which pages are extracted and used in the main TeX file.
#
# For example:
# FIG_MASTER_FILE = figs/fig.pdf
# FIG_PAGES = 1 2 3 4 5
# makes:
# figs/fig1.pdf ... figs/fig5.pdf from figs/fig.pdf
#
FIG_MASTER_FILE = figs/fig.pdf
FIG_PAGES = 1 2 3 4 5
#+END_SRC

** TeX 組版 (コンパイル) の確認

=Makefile= のあるディレクトリで, =make= を実行すれば,
資料の pdf ファイルが生成される.

** 不要なファイルの変更,削除

テンプレートを正しく利用できたら,
以下のファイルは,自身の資料に合う内容に変更するか削除し,
そのまま commit に入らないように気を付ける.

+ README.org (このファイル)
+ *.pdf

なお, =project.mk= にて, =FIG_MASTER_FILE= を設定した際には, =FIG_MASTER_FILE= 以外のファイルを消すこと.
また,資料が完成した際には,最終成果物としてpdfを commit に追加したほうがよい.

* トラブルシューティング
** TeXのバージョンによる図の挿入方法の違い
TeX のバージョンによって,図を挿入する作法が若干異なる.
比較的最近のTeX (texlive) を使って xbb 形式を用いていれば,
テンプレートの =Makefile= がそのまま利用できるが,
少し古い ptex を用いる場合は,bb 形式であるため,図の挿入に失敗する.

できれば,新しい texlive を使うことを推奨するが,texlive の更新が不可能な場合は,
Makefile 中の xbb を全て bb に置き換える.例えば,以下の通り.
他にも変更個所がいくつかあるので気を付ける.
#+BEGIN_SRC diff
@@ -80,7 +80,7 @@ FIG_PAGES = 1 2 3 4 5

TEX_FILES = ${PROJECT}.tex
FIG_PDF_FILES := $(foreach n, $(FIG_PAGES), $(call addpage,$(FIG_MASTER_FILE),$(n)))
-FIG_EBB_FILES := $(foreach n, $(FIG_PAGES), $(call addpage,$(FIG_MASTER_FILE),$(n),xbb))
+FIG_EBB_FILES := $(foreach n, $(FIG_PAGES), $(call addpage,$(FIG_MASTER_FILE),$(n),bb))

#####################################################################
# Common rules
@@ -98,7 +98,7 @@ ${FIG_PDF_FILES} : ${FIG_MASTER_FILE}
-dLastPage=$(call pagenum,$*) \
-sOutputFile=$@ ${FIG_MASTER_FILE} 2>/dev/null

-${FIG_EBB_FILES} : %.xbb : %.pdf
+${FIG_EBB_FILES} : %.bb : %.pdf
@echo "Making $@ from $<"
@${GS} -sDEVICE=bbox -r100 $< 2> $@
#+END_SRC

* 資料作成の諸注意
リポジトリ構成等の資料作成の諸注意については,
別途以下を参照のこと.(GitHub のログインが必要).

1) [[https://github.com/nomlab/nompedia/wiki/About-presentation][研究会発表の準備手順と注意点]]
2) [[https://github.com/nomlab/nompedia/wiki/About-paper-submission#user-content-%E8%AB%96%E6%96%87%E5%9F%B7%E7%AD%86%E3%81%AE%E9%9A%9B%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9][論文執筆の際の注意点]]

リポジトリ作成の際に以下を注意すること.
+ 不要なファイルはコミットしない.
+ 他人が後から使えるように配慮する.(資料の cls ファイルや fig も入れておく)
+ 独自の方法でコンパイルが必要な場合は,その旨を README に記載する.
#+TITLE: �V�l���C�ۑ�(New)
#+AUTHOR: Nomura Laboratory, Okayama University
#+EMAIL:
#+DATE:
#+OPTIONS: H:3 num:2 toc:nil
#+OPTIONS: ^:nil @:t \n:nil ::t |:t f:t TeX:t
#+OPTIONS: skip:nil
#+OPTIONS: author:t
#+OPTIONS: email:nil
#+OPTIONS: creator:nil
#+OPTIONS: timestamp:nil
#+OPTIONS: timestamps:nil
#+OPTIONS: d:nil
#+OPTIONS: tags:t
#+TEXT:
#+DESCRIPTION:
#+KEYWORDS:
#+LANGUAGE: ja
#+STARTUP: odd
#+LATEX_CLASS: jsarticle
#+LATEX_CLASS_OPTIONS: [a4j]
# #+LATEX_HEADER: \usepackage{plain-article}
# #+LATEX_HEADER: \renewcommand\maketitle{}
# #+LATEX_HEADER: \pagestyle{empty}
# #+LaTeX: \thispagestyle{empty}

* Debian�C���X�g�[���菇
** (1) �V�X�e������̐ݒ�
*** Select a language
+ Language: English��I��
** (2) �n��̐ݒ�
*** Select your location
+ Country, territory or area: other -> Asia -> Japan ��I��
** (3) ���P�[���̐ݒ�
*** Configure locales
+ Country to base default locale settings on: United States - en_US.UTF-8 ��I��
** (4) �L�[�{�[�h�̐ݒ�
*** Configure the Keyboard
+ Keymap to use: Japanese
** (5) �l�b�g���[�N�̐ݒ�
*** Configure the network
+ Hostname: sugi(�m�[�h1�p�Ȃ�sugi1�C�m�[�h2�p�Ȃ�sugi2)
+ Domain name: �Ȃ�
** (6) ���[�U�ƃp�X���[�h�̐ݒ�
*** Set up users and passwords
+ Root password: �p�X���[�h(���‚���)
+ Re-enter password to verify:
+ Full name for the new user: �t���l�[��(��: Keisuke Sugi)
+ Username for your account: �A�J�E���g��(��: sugi)
+ Choose a password for the new user:�@�p�X���[�h(���‚���)
+ Re-enter password to verify:
** (7) �^�C���]�[���̐ݒ�
*** Configure the clock
+ Select yout time zone:
** (8) �p�[�e�B�V�����̐ݒ�
*** Partition disks
+ Manual ��I��
*** SCSI1 (0.0.0) (sda) - 320.1GB Hitachi HDS72103
+ Create new empty partition table on this deice? <Yes>
+ pri/log 320.1GB FREE SPACE
+ Create a new partition -> 196 MB -> Primary -> Beginning -> Mount point:
-> /boot - static files of the boot loader -> Done setting up the partition
+ Create a new partition -> 315.9 GB(�c��̗̈悩��4GB(��������2�{)�̃T�C�Y�������������傫��) -> Primary -> Beginning
-> Mount point:-> / - the root file system -> Done setting up the partition
+ Create a new partition -> 4 GB -> Primary -> Beginning -> Use as:
-> Use as: swap area -> Done setting up the partition

+ Finish patitioning and write changes to disk ��I��
+ Write the changes to disks? <Yes>

** (9) �p�b�P�[�W�̐ݒ�
*** Configure the package manager
+ Scan another CD or DVD? <No>
+ Use a network mirror? <Yes>
+ Debian archive mirror country: Japan
+ Debian archive mirror: ftp.riken.jp
+ HTTP proxy information (blank for none):�Ȃ�
** (10) �����ւ̋��͂̐ݒ�
*** Configuring popularity-contest
+ Participate in the package usage survey? <No>
** (11) �C���X�g�[������\�t�g�E�F�A�̐ݒ�
*** Software selection
+ Choose software to install:�X�y�[�X�L�[��p���āuSSH server�v�ȊO�̂��ׂẴ`�F�b�N���O��
** (12) �u�[�g���[�_�̐ݒ�
*** Install the GRUB boot loader on a hard disk (sda�̂Ƃ�)
+ Install the GRUB boot loader to the master boot record? <Yes>
+ Device for boot loader installation: �Ȃ�
*** Install the GRUB boot loader on a hard disk (sdb�Csdc�̂Ƃ�)
+ Install the GRUB boot loader to the master boot record? <No>
+ Device for boot loader installation: �Ȃ�
** (13) �V�X�e���N���b�N�̐ݒ�
*** Finish the installation
+ Is the system clock set to UTC? <Yes>

* Linux�č\�z�̎菇
** �‹��ݒ�
*** (1) sudo�����̕t�^
+ ���[�U��sudo������^����D�ȉ��̃R�}���h�����s����D
: $ su
: # visudo (�G�f�B�^���N������̂ŁC"root ALL=(ALL) ALL"�̒����"ogura-i ALL=(ALL) ALL"��lj�����)
*** (2) git��gcc�̃C���X�g�[��
+ git��gcc���C���X�g�[������D�ȉ��̃R�}���h�����s����D
: $ sudo apt-get update
: $ sudo apt-get install git
: $ sudo apt-get install gcc
*** (3) �J�[�l���č\�z�Ŏg�p���郉�C�u�����ƃR�}���h�̃C���X�g�[��
+ �J�[�l���č\�z�Ŏg�p���郉�C�u�����ƃR�}���h���C���X�g�[������D�ȉ��̃R�}���h�����s����D
: $ sudo apt-get install libncurses5-dev (make menuconfig��f�o�C�X�����ŗp����)
: $ sudo apt-get install bc (�J�[�l���̍č\�z�Ŏ��s����R�}���h�ŗp����)
** Linux�J�[�l���̎擾
*** (1) Linux�̃\�[�X�R�[�h�̎擾
+ Linux�̃\�[�X�R�[�h���擾����DLinux�̃\�[�X�R�[�h��Git�ŊǗ�����Ă���DGit�Ƃ̓I�[�v���\�[�X�̕��U�^�o�[�W�����Ǘ��V�X�e���ł���D���L��Git���|�W�g������N���[�����CLinux�̃\�[�X�R�[�h���擾����D
: git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git
+ ���|�W�g���Ƃ̓f�B���N�g����ۑ�����ꏊ�̂��Ƃł���C�N���[���Ƃ̓��|�W�g���̓��e��C�ӂ̃f�B���N�g���ɕ������邱�Ƃł���D�{�菇���ł�/home/ogura-i/git�ȉ��Ń\�[�X�R�[�h���Ǘ�����D/home/ogura-i�ňȉ��̃R�}���h�����s����D
: $ mkdir git
: $ cd git
: $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git
+ ���s��Cmkdir�R�}���h�ɂ��/home/ogura-i�ȉ���git�f�B���N�g�����쐬�����D�����āCcd�R�}���h�ɂ��Cgit�f�B���N�g���Ɉړ�����Dgit clone�R�}���h�ɂ��C/home/ogura-i/git�ȉ���linux-stable�f�B���N�g�����쐬�����Dlinux-stable�ȉ���Linux�̃\�[�X�R�[�h���i�[����Ă���D
*** (2) �u�����`�̐؂�ւ�
+ Linux�̃\�[�X�R�[�h�̃o�[�W������؂�ւ��邽�߁C�u�����`�̍쐬�Ɛ؂�ւ����s���D�u�����`�Ƃ͊J���̗������Ǘ����邽�߂̕���ł���D/home/ogura-i/git/linux-stable�ňȉ��̃R�}���h�����s����D
: $ git checkout -b 3.15 v3.15
+ ���s��Cv3.15�Ƃ����^�O�������R�~�b�g����u�����`3.15���쐬����C�u�����`3.15�ɐ؂�ւ��D�R�~�b�g�Ƃ͂��鎞�_�ɂ�����J���̏�Ԃ��L�^�������̂ł���D�^�O�Ƃ̓R�~�b�g�����ʂ��邽�߂ɂ‚����ł���D
** �J�[�l���̍č\�z
+ �ȉ��̎菇�ŃJ�[�l���̍č\�z���s���D�R�}���h��/home/ogura-i/git/linux-stable�ȉ��Ŏ��s����D
*** (1) .config �t�@�C���̍쐬
+ .config�t�@�C�����쐬����D.config�t�@�C���Ƃ̓J�[�l���̐ݒ���L�q�����R���t�B�M�����[�V�����t�@�C���ł���D�ȉ��̃R�}���h�����s���Cdefconfig �t�@�C������ɁC�J�[�l���̐ݒ���s���Ddefconfig �t�@�C���ɂ̓f�t�H���g�̐ݒ肪�L�q����Ă���D
: $ make defconfig
+ ���s��C/home/ogura-i/git/linux-stable�ȉ���.config�t�@�C�����쐬�����D
*** (2) �J�[�l���̃R���p�C��
+ Linux�J�[�l�����R���p�C������D�ȉ��̃R�}���h�����s����D
: $ make bzImage -j8
��L�R�}���h�́u-j�v�I�v�V�����́C�����Ɏ��s�ł���W���u�����w�肷��D�W���u����s�p�ӂɑ��₷�ƃ������s���ɂ��C���s���x���ቺ����ꍇ������D�W���u����CPU�̃R�A��*2�����ʓI�ł���D�R�}���h���s��C/home/ogura-i/git/linux-stable/arch/x86/boot�ȉ���bzImage�Ƃ������O�̈��k�J�[�l���C���[�W���쐬�����D�J�[�l���C���[�W�Ƃ͎��s�”\�`���̃J�[�l�����܂ރt�@�C���ł���D�����ɁC/home/ogura-i/git/linux-stable�ȉ��ɂ��ׂẴJ�[�l���V���{���̃A�h���X���L�q����System.map���쐬�����D��0�l���V���{���Ƃ̓J�[�l���̃v���O�������i�[���ꂽ�������A�h���X�ƑΉ��t����ꂽ������̂��Ƃł���D
*** (3) �J�[�l���̃C���X�g�[��
+ �R���p�C�������J�[�l�����C���X�g�[������D�ȉ��̃R�}���h�����s����D
: $ sudo cp /home/ogura-i/git/linux-stable/arch/x86/boot/bzImage /boot/vmlinuz-3.15.0-linux
: $ sudo cp /home/ogura-i/git/linux-stable/System.map /boot/System.map-3.15.0-linux
+ ���s��CbzImage��System.map��boot�ȉ��ɂ��ꂼ��vmlinuz-3.15.0-linux��System.map-3.15.0-linux�Ƃ������O�ŃR�s�[�����D
*** (4) �J�[�l�����W���[���̃R���p�C��
+ �J�[�l�����W���[�����R���p�C������D�J�[�l�����W���[���Ƃ͋@�\���g�����邽�߂̃o�C�i���t�@�C���ł���D�ȉ��̃R�}���h�����s����D
: $ make modules
*** (5) �J�[�l�����W���[���̃C���X�g�[��
+ �R���p�C�������J�[�l�����W���[�����C���X�g�[������D�ȉ��̃R�}���h�����s����D
: $ sudo make modules_install
+ �������ʂ̍Ō�̍s�͈ȉ��̂悤�ɕ\�������D����̓J�[�l�����W���[�����C���X�g�[�������f�B���N�g������\���Ă���D
: DEPMOD 3.15.
+ ��L�̗�ł́C/lib/modules/3.15.0 �f�B���N�g���ɃJ�[�l�����W���[�����C���X�g�[������Ă���D���̃f�B���N�g�����͎菇(6) �ŕK�v�ƂȂ邽�߁C�T���Ă����D
*** (6) ����RAM�f�B�X�N�̍쐬
+ ����RAM�f�B�X�N���쐬����D����RAM�f�B�X�N�Ƃ͏������[�g�t�@�C���V�X�e���̂��Ƃł���D����͎��ۂ̃��[�g�t�@�C���V�X�e�����g�p�ł���悤�ɂȂ�O�Ƀ}�E���g�����D�ȉ��̃R�}���h�����s����D
: $ sudo update-initramfs -c -k 3.15.0
+ �菇(5) �ōT���Ă������f�B���N�g�������R�}���h�̈����Ƃ��ė^����D���s��C/boot �ȉ��ɏ���RAM �f�B�X�Ninitrd.img-3.15.0 ���쐬�����D
*** (7) �u�[�g���[�_�̐ݒ�
+ �V�X�e���R�[�������������J�[�l�����u�[�g���[�_����N���”\�ɂ��邽�߂ɁC�u�[�g���[�_��ݒ肷��D�u�[�g���[�_�̐ݒ�t�@�C����/boot/grub/grub.cfg �ł���D�G���g����lj����邽�߂ɂ͂��̃t�@�C����ҏW����K�v������DDebian7.10 �Ŏg�p����Ă���u�[�g���[�_��GRUB2 �ł���DGRUB2 �ŃJ�[�l���̃G���g����lj�����ہC�ݒ�t�@�C���𒼐ڕҏW���Ȃ��D/etc/grub.d �ȉ��ɃG���g���lj��p�̃X�N���v�g���쐬���C���̃X�N���v�g�����s���邱�ƂŃG���g����lj�����D�u�[�g���[�_��ݒ肷��菇���ȉ��Ɏ����D
**** (A) �G���g���lj��p�̃X�N���v�g�̍쐬
+ �J�[�l���̃G���g����lj����邽�߁C�G���g���lj��p�̃X�N���v�g���쐬����D�{�菇���ł́C�����̃t�@�C�����ɕ킢�쐬����X�N���v�g�̃t�@�C������11 linux-3.15.0 �Ƃ���D�X�N���v�g�̋L�q����ȉ��Ɏ����D
: 1 #!/bin/sh -e
: 2 echo "Adding my custom Linux to GRUB2"
: 3 cat << EOF
: 4 menuentry "My custom Linux" {
: 5 set root=(hd0,1)
: 6 linux /vmlinuz-3.15.0-linux ro root=/dev/sda2 quiet
: 7 initrd /initrd.img-3.15.0
: 8 }
: 9 EOF
+ �X�N���v�g�ɋL�q���ꂽ�e���ڂɂ‚��Ĉȉ��Ɏ����D
***** (a) menuentry < �\����>
+ < �\����>: �J�[�l���I����ʂɕ\������閼�O
***** (b) set root=(<HDD �ԍ�>,< �p�[�e�B�V�����ԍ�>)
+ <HDD �ԍ�>: �J�[�l�����ۑ�����Ă���HDD �̔ԍ�
+ < �p�[�e�B�V�����ԍ�>: HDD ��/boot �����蓖�Ă�ꂽ�p�[�e�B�V�����ԍ�
***** (c) linux < �J�[�l���C���[�W�̃t�@�C����>
+ < �J�[�l���C���[�W�̃t�@�C����>: �N������J�[�l���̃J�[�l���C���[�W
***** (d) ro <root �f�o�C�X>
+ <root �f�o�C�X>: �N�����ɓǂݍ��ݐ�p�Ń}�E���g����f�o�C�X�D
***** (e) root=< ���[�g�t�@�C���V�X�e��> < ���̑��̃u�[�g�I�v�V����>
+ < ���[�g�t�@�C���V�X�e��>: /root �����蓖�Ă��p�[�e�B�V����
+ < ���̑��̃u�[�g�I�v�V����>: quiet �̓J�[�l���̋N�����ɏo�͂��郁�b�Z�[�W���ȗ�����D
***** (f) initrd < ����RAM �f�B�X�N��>
+ < ����RAM �f�B�X�N��>: �N�����Ƀ}�E���g���鏉��RAM �f�B�X�N��
**** (B) ���s�����̕t�^
+ /etc/grub.d �ňȉ��̃R�}���h�����s���C�쐬�����X�N���v�g�Ɏ��s������t�^����D
: $ sudo chmod +x 11_linux-3.15.0
**** (C) �G���g���lj��p�̃X�N���v�g�̎��s
+ �ȉ��̃R�}���h�����s���C�쐬�����X�N���v�g�����s����D
: $ sudo update-grub
+ ���s��C/boot/grub/grub.cfg �ɃV�X�e���R�[�������������J�[�l���̃G���g�����lj������D
*** (8) �ċN��
+ �C�ӂ̃f�B���N�g���ňȉ��̃R�}���h�����s���C�v�Z�@���ċN��������D
: $ sudo reboot
+ GRUB2 �̃J�[�l���I����ʂɃG���g�����lj�����Ă���D�菇(7) �̃X�N���v�g��p�����ꍇ�C�J�[�l���I����ʂ�My custom Linux ��I�����C�N������D




Loading

0 comments on commit 0c09941

Please sign in to comment.